diff options
Diffstat (limited to '')
| -rw-r--r-- | private/inc/smbtrsup.h | 230 |
1 files changed, 230 insertions, 0 deletions
diff --git a/private/inc/smbtrsup.h b/private/inc/smbtrsup.h new file mode 100644 index 000000000..ee9298130 --- /dev/null +++ b/private/inc/smbtrsup.h @@ -0,0 +1,230 @@ +/*++ + +Copyright (c) 1990 Microsoft Corporation + +Module Name: + + smbtrsup.h + +Abstract: + + This module provides the interface to the kernel mode SmbTrace + component within the LanMan server and redirector. + The interface providing user-level access to SmbTrace is found in + nt\private\inc\smbtrace.h + +Author: + + Stephan Mueller (t-stephm) 20-July-1992 + +Revision History: + + 20-July-1992 t-stephm + + Created + +--*/ + +#ifndef _SMBTRSUP_ +#define _SMBTRSUP_ + +// +// Selection of components in which SmbTrace will run. +// Pass the appropriate value to SmbTraceStart and SmbTraceStop, +// and test the appropriate element of SmbTraceActive and +// SmbTraceTransitioning. The actual tracing calls do not require +// a Component parameter as it is implied by the routine being called. +// + +typedef enum _SMBTRACE_COMPONENT { + SMBTRACE_SERVER, + SMBTRACE_REDIRECTOR +} SMBTRACE_COMPONENT; + + +extern BOOLEAN SmbTraceActive[]; + +// +// SmbTrace support exported routines +// + + +// +// Initialize the SMB tracing package +// +NTSTATUS +SmbTraceInitialize ( + IN SMBTRACE_COMPONENT Component + ); + +// +// Terminate the SMB tracing package +// +VOID +SmbTraceTerminate ( + IN SMBTRACE_COMPONENT Component + ); + +// +// Start tracing +// +NTSTATUS +SmbTraceStart( + IN ULONG InputBufferLength, + IN ULONG OutputBufferLength, + IN OUT PVOID ConfigInOut, + IN PFILE_OBJECT FileObject, + IN SMBTRACE_COMPONENT Component + ); + +// +// Stop tracing +// +NTSTATUS +SmbTraceStop( + IN PFILE_OBJECT FileObject OPTIONAL, + IN SMBTRACE_COMPONENT Component + ); + + +// +// VOID +// SMBTRACE_SRV( +// IN PMDL SmbMdl, +// ) +// +// Routine description: +// +// If SmbTrace is turned on, this macro calls SmbTraceCompleteSrv +// to send the SMB to the smbtrace program in user mode. This routine +// is specific to the LanMan server. Use it for tracing an SMB +// contained in an Mdl. +// +// Arguments: +// +// SmbMdl - a pointer to the Mdl containing the SMB that is about +// to be sent. +// +// Return Value: +// +// None +// + +#define SMBTRACE_SRV(smbmdl) \ + if ( SmbTraceActive[SMBTRACE_SERVER] ) { \ + SmbTraceCompleteSrv( (smbmdl), NULL, 0 ); \ + } + +// +// VOID +// SMBTRACE_SRV2( +// IN PVOID Smb, +// IN ULONG SmbLength +// ) +// +// Routine description: +// +// If SmbTrace is turned on, this macro calls SmbTraceCompleteSrv +// to send the SMB to the smbtrace program in user mode. This routine +// is specific to the LanMan server. Use it for tracing an SMB +// found in contiguous memory. +// +// Arguments: +// +// Smb - a pointer to the SMB that is about to be sent. +// +// SmbLength - the length of the SMB. +// +// Return Value: +// +// None +// + +#define SMBTRACE_SRV2(smb,smblength) \ + if ( SmbTraceActive[SMBTRACE_SERVER] ) { \ + SmbTraceCompleteSrv( NULL, (smb), (smblength) ); \ + } + +// +// Identify a packet for tracing in the server. +// Do not call this routine directly, always use the SMBTRACE_SRV macro +// +VOID +SmbTraceCompleteSrv ( + IN PMDL SmbMdl, + IN PVOID Smb, + IN CLONG SmbLength + ); + +// +// VOID +// SMBTRACE_RDR( +// IN PMDL SmbMdl +// ) +// +// Routine description: +// +// If SmbTrace is turned on, this macro calls SmbTraceCompleteRdr +// to send the SMB to the smbtrace program in user mode. This routine +// is specific to the LanMan redirector. Use it for tracing an SMB +// contained in an Mdl. +// +// Arguments: +// +// SmbMdl - a pointer to the Mdl containing the SMB that is about +// to be sent. +// +// Return Value: +// +// None +// + +#define SMBTRACE_RDR(smbmdl) \ + if ( SmbTraceActive[SMBTRACE_REDIRECTOR] ) { \ + SmbTraceCompleteRdr( (smbmdl), NULL, 0 ); \ + } + +// +// VOID +// SMBTRACE_RDR2( +// IN PVOID Smb, +// IN ULONG SmbLength +// ) +// +// Routine description: +// +// If SmbTrace is turned on, this macro calls SmbTraceCompleteRdr +// to send the SMB to the smbtrace program in user mode. This routine +// is specific to the LanMan redirector. Use it for tracing an SMB +// found in contiguous memory. +// +// Arguments: +// +// Smb - a pointer to the SMB that is about to be sent. +// +// SmbLength - the length of the SMB. +// +// Return Value: +// +// None +// + +#define SMBTRACE_RDR2(smb,smblength) \ + if ( SmbTraceActive[SMBTRACE_REDIRECTOR] ) { \ + SmbTraceCompleteRdr( NULL, (smb), (smblength) ); \ + } + +// +// Identify a packet for tracing in the redirector. +// Do not call this routine directly, always use one of the SMBTRACE_RDR +// macros. +// +VOID +SmbTraceCompleteRdr ( + IN PMDL SmbMdl, + IN PVOID Smb, + IN CLONG SmbLength + ); + +#endif // _SMBTRSUP_ + |