/**********************************************************************/
/** Microsoft Windows NT **/
/** Copyright(c) Microsoft Corp., 1991 **/
/**********************************************************************/
/*
user.c
This module implements the "user" command of the W3 Server
debugger extension DLL.
The "user" command dumps the info pertaining to a specific user.
There is one parameter to this command. If this parameter is
positive, it is assumed to be the address of a USER_DATA structure
for a specific user. If the parameter is negative, its absolute
value is assumed to be a user ID. If no parameter is given, info
for all connected users is dumped.
FILE HISTORY:
KeithMo 13-Aug-1992 Created.
*/
#include "w3dbg.h"
//
// Private prototypes.
//
VOID DumpUserInfo( HANDLE hCurrentProcess,
USER_DATA * puser );
CHAR * InterpretState( USER_STATE state );
CHAR * InterpretXferType( XFER_TYPE xferType );
CHAR * InterpretXferMode( XFER_MODE xferMode );
VOID InterpretFlags( DWORD dwFlags );
/*******************************************************************
NAME: user
SYNOPSIS: Displays the info for a specific user.
ENTRY: hCurrentProcess - Handle to the current process.
hCurrentThread - Handle to the current thread.
dwCurrentPc - The current program counter
(EIP for x86, FIR for MIPS).
lpExtensionApis - Points to a structure containing
pointers to the debugger functions
that the command may invoke.
lpArgumentString - Points to any arguments passed
to the command.
NOTES: The argument string must contain either the address of
a USER_DATA structure (if positive) or a user ID (if
negative).
HISTORY:
KeithMo 13-Aug-1992 Created.
********************************************************************/
VOID user( HANDLE hCurrentProcess,
HANDLE hCurrentThread,
DWORD dwCurrentPc,
LPVOID lpExtensionApis,
LPSTR lpArgumentString )
{
LONG lParam;
USER_DATA user;
//
// Grab the debugger entrypoints.
//
GrabDebugApis( lpExtensionApis );
//
// Evaluate the parameter (if present).
//
if( ( lpArgumentString == NULL ) || ( *lpArgumentString == '\0' ) )
{
lParam = 0;
}
else
{
lParam = (LONG)DebugEval( lpArgumentString );
}
//
// Interpret the parameter.
//
if( lParam > 0 )
{
//
// User specified an address. Dump the user info
// at that address.
//
ReadProcessMemory( hCurrentProcess,
(LPVOID)lParam,
(LPVOID)&user,
sizeof(user),
(LPDWORD)NULL );
DumpUserInfo( hCurrentProcess, &user );
}
else
{
//
// User specified either nothing (0) or a user ID (< 0).
//
LIST_ENTRY list;
LIST_ENTRY * plist;
LIST_ENTRY * plistHead;
lParam = -lParam;
plistHead = (LIST_ENTRY *)DebugEval( "listUserData" );
ReadProcessMemory( hCurrentProcess,
(LPVOID)plistHead,
(LPVOID)&list,
sizeof(list),
(LPDWORD)NULL );
plist = list.Flink;
while( plist != plistHead )
{
ReadProcessMemory( hCurrentProcess,
(LPVOID)CONTAINING_RECORD( plist,
USER_DATA,
link ),
(LPVOID)&user,
sizeof(user),
(LPDWORD)NULL );
if( ( lParam == 0 ) || ( user.idUser == (DWORD)lParam ) )
{
DumpUserInfo( hCurrentProcess, &user );
if( lParam != 0 )
{
break;
}
}
plist = user.link.Flink;
//
// Check for CTRL-C, to let the user bag-out early.
//
if( DebugCheckCtrlC() )
{
break;
}
}
if( ( lParam != 0 ) && ( plist == plistHead ) )
{
DebugPrint( "user ID %ld not found\n", lParam );
}
}
} // user
VOID DumpUserInfo( HANDLE hCurrentProcess,
USER_DATA * puser )
{
char szDir[MAX_PATH];
int i;
DebugPrint( "user @ %08lX:\n", puser );
DebugPrint( " link.Flink = %08lX\n", puser->link.Flink );
DebugPrint( " link.Blink = %08lX\n", puser->link.Blink );
DebugPrint( " dwFlags = %08lX\n", puser->dwFlags );
InterpretFlags( puser->dwFlags );
DebugPrint( " sControl = %d\n", puser->sControl );
DebugPrint( " sData = %d\n", puser->sData );
DebugPrint( " hToken = %08lX\n", puser->hToken );
DebugPrint( " state = %s\n", InterpretState( puser->state ) );
DebugPrint( " idUser = %lu\n", puser->idUser );
DebugPrint( " tConnect = %08lX\n", puser->tConnect );
DebugPrint( " tAccess = %08lX\n", puser->tAccess );
DebugPrint( " xferType = %s\n", InterpretXferType( puser->xferType ) );
DebugPrint( " xferMode = %s\n", InterpretXferMode( puser->xferMode ) );
DebugPrint( " inetLocal = %s\n", inet_ntoa( puser->inetLocal ) );
DebugPrint( " inetHost = %s\n", inet_ntoa( puser->inetHost ) );
DebugPrint( " inetData = %s\n", inet_ntoa( puser->inetData ) );
DebugPrint( " portData = %u\n", puser->portData );
DebugPrint( " hDir = %08lX\n", puser->hDir );
DebugPrint( " pIoBuffer = %08lX\n", puser->pIoBuffer );
DebugPrint( " pszRename = %s\n", puser->pszRename );
for( i = 0 ; i < 26 ; i++ )
{
if( puser->apszDirs[i] != NULL )
{
ReadProcessMemory( hCurrentProcess,
puser->apszDirs[i],
szDir,
sizeof(szDir),
(LPDWORD)NULL );
DebugPrint( " dir %c: = %s\n", 'A'+i, szDir );
}
}
DebugPrint( " szDir = %s\n", puser->szDir );
DebugPrint( " szUser = %s\n", puser->szUser );
DebugPrint( " idThread = %lu\n", puser->idThread );
DebugPrint( "\n" );
} // DumpUserInfo
CHAR * InterpretState( USER_STATE state )
{
CHAR * pszResult = "unknown";
switch( state )
{
case Embryonic :
pszResult = "Embryonic";
break;
case WaitingForUser :
pszResult = "WaitingForUser";
break;
case WaitingForPass :
pszResult = "WaitingForPass";
break;
case LoggedOn :
pszResult = "LoggedOn";
break;
case Disconnected :
pszResult = "Disconnected";
break;
default :
break;
}
return pszResult;
} // InterpretState
CHAR * InterpretXferType( XFER_TYPE xferType )
{
CHAR * pszResult = "unknown";
switch( xferType )
{
case AsciiType :
pszResult = "ASCII";
break;
case BinaryType :
pszResult = "BINARY";
break;
default :
break;
}
return pszResult;
} // InterpretXferType
CHAR * InterpretXferMode( XFER_MODE xferMode )
{
CHAR * pszResult = "unknown";
switch( xferMode )
{
case StreamMode :
pszResult = "STREAM";
break;
case BlockMode :
pszResult = "BLOCK";
break;
default :
break;
}
return pszResult;
} // InterpretXferMode
typedef struct FLAG_MAP
{
DWORD flag;
CHAR * pszName;
} FLAG_MAP;
FLAG_MAP flag_map[] =
{
{ UF_MSDOS_DIR_OUTPUT, "UF_MSDOS_DIR_OUTPUT" },
{ UF_ANNOTATE_DIRS, "UF_ANNOTATE_DIRS" },
{ UF_READ_ACCESS, "UF_READ_ACCESS" },
{ UF_WRITE_ACCESS, "UF_WRITE_ACCESS" },
{ UF_OOB_ABORT, "UF_OOB_ABORT" },
{ UF_RENAME, "UF_RENAME" },
{ UF_PASSIVE, "UF_PASSIVE" },
{ UF_ANONYMOUS, "UF_ANONYMOUS" },
{ UF_TRANSFER, "UF_TRANSFER" },
{ UF_OOB_DATA, "UF_OOB_DATA" }
};
#define NUM_FLAG_MAP (sizeof(flag_map) / sizeof(flag_map[0]))
VOID InterpretFlags( DWORD dwFlags )
{
INT i;
FLAG_MAP * pmap = flag_map;
for( i = 0 ; i < NUM_FLAG_MAP ; i++ )
{
if( dwFlags & pmap->flag )
{
DebugPrint( " %s\n", pmap->pszName );
dwFlags &= ~pmap->flag;
}
pmap++;
}
if( dwFlags != 0 )
{
DebugPrint( " Remaining flags = %08lX\n", dwFlags );
}
} // InterpretFlags