windows-nt/Source/XPSP1/NT/inetsrv/iis/svcs/ftp/server/ftpinst.hxx
2020-09-26 16:20:57 +08:00

359 lines
10 KiB
C++

/*++
Copyright (c) 1996 Microsoft Corporation
Module Name:
ftpinst.hxx
Abstract:
This module defines the FTP_IIS_SERVICE type
Author:
Johnson Apacible (johnsona) 04-Sep-1996
--*/
#ifndef _FTPINST_HXX_
#define _FTPINST_HXX_
#include "iistypes.hxx"
#include "stats.hxx"
#include "type.hxx"
typedef LPUSER_DATA PICLIENT_CONNECTION;
typedef BOOL (*PFN_CLIENT_CONNECTION_ENUM)( PICLIENT_CONNECTION pcc,
LPVOID pContext);
// specifies the size of cache block for padding ==> to avoid false sharing
# define MAX_CACHE_BLOCK_SIZE ( 64)
class FTP_IIS_SERVICE : public IIS_SERVICE {
public:
FTP_IIS_SERVICE(
IN LPCTSTR lpszServiceName,
IN LPCSTR lpszModuleName,
IN LPCSTR lpszRegParamKey,
IN DWORD dwServiceId,
IN ULONGLONG SvcLocId,
IN BOOL MultipleInstanceSupport,
IN DWORD cbAcceptExRecvBuffer,
IN ATQ_CONNECT_CALLBACK pfnConnect,
IN ATQ_COMPLETION pfnConnectEx,
IN ATQ_COMPLETION pfnIoCompletion
)
:IIS_SERVICE(
lpszServiceName,
lpszModuleName,
lpszRegParamKey,
dwServiceId,
SvcLocId,
MultipleInstanceSupport,
cbAcceptExRecvBuffer,
pfnConnect,
pfnConnectEx,
pfnIoCompletion
)
{
InitializeListHead( & m_InstanceList );
INITIALIZE_CRITICAL_SECTION( &m_csInstanceLock);
};
~FTP_IIS_SERVICE()
{
DeleteCriticalSection( &m_csInstanceLock);
}
VOID LockInstanceList( VOID) { EnterCriticalSection( &m_csInstanceLock); }
VOID UnLockInstanceList( VOID) { LeaveCriticalSection( &m_csInstanceLock); }
virtual DWORD GetServiceConfigInfoSize(IN DWORD dwLevel);
virtual BOOL AddInstanceInfo( IN DWORD dwInstance, IN BOOL fMigrateRoots );
virtual DWORD DisconnectUsersByInstance( IN IIS_SERVER_INSTANCE * pInstance );
BOOL AggregateStatistics(
IN PCHAR pDestination,
IN PCHAR pSource
);
BOOL
GetGlobalStatistics(
IN DWORD dwLevel,
OUT PCHAR *pBuffer
);
LIST_ENTRY m_InstanceList;
CRITICAL_SECTION m_csInstanceLock;
};
typedef FTP_IIS_SERVICE *PFTP_IIS_SERVICE;
//
// This is the FTP version of the instance. Will contain all the
// FTP specific operations.
//
typedef enum _ISOLATION_MODE
{
NoIsolation = 0,
StandAloneIsolation,
EnterpriseIsolation,
IsolationModeOverflow
} ISOLATION_MODE;
class FTP_SERVER_INSTANCE : public IIS_SERVER_INSTANCE {
public:
FTP_SERVER_INSTANCE(
IN PFTP_IIS_SERVICE pService,
IN DWORD dwInstanceId,
IN USHORT sPort,
IN LPCSTR lpszRegParamKey,
IN LPWSTR lpwszAnonPasswordSecretName,
IN LPWSTR lpwszRootPasswordSecretName,
IN BOOL fMigrateVroots
) ;
~FTP_SERVER_INSTANCE();
//
// Instance start & stop
//
virtual DWORD StartInstance();
virtual DWORD StopInstance();
//
// VIRTUALS for service specific params/RPC admin
//
virtual BOOL SetServiceConfig(IN PCHAR pConfig );
virtual BOOL GetServiceConfig(IN OUT PCHAR pConfig,IN DWORD dwLevel);
virtual BOOL GetStatistics( IN DWORD dwLevel, OUT PCHAR *pBuffer);
virtual BOOL ClearStatistics( VOID );
virtual BOOL DisconnectUser( IN DWORD dwIdUser );
virtual BOOL EnumerateUsers( OUT PCHAR* pBuffer, OUT PDWORD nRead );
virtual VOID MDChangeNotify( MD_CHANGE_OBJECT * pco );
BOOL FreeAllocCachedClientConn(VOID);
PICLIENT_CONNECTION AllocClientConnFromAllocCache(VOID);
VOID FreeClientConnToAllocCache(IN PICLIENT_CONNECTION pClient);
//
// Initialize the configuration data from registry information
//
// Arguments
// hkeyReg key to the registry entry for parameters
// FieldsToRead bitmapped flags indicating which data to be read.
//
// Returns:
// NO_ERROR on success
// Win32 error code otherwise
//
DWORD InitFromRegistry( IN FIELD_CONTROL FieldsToRead);
DWORD
ReadAuthentInfo(
IN BOOL ReadAll = TRUE,
IN DWORD SingleItemToRead = 0
);
DWORD
GetConfigInformation( OUT LPFTP_CONFIG_INFO pConfigInfo);
DWORD
SetConfigInformation( IN LPFTP_CONFIG_INFO pConfigInfo);
BOOL IsValid( VOID) const { return ( m_fValid); }
VOID LockConfig( VOID) { EnterCriticalSection( &m_csLock); }
VOID UnLockConfig( VOID) { LeaveCriticalSection( &m_csLock); }
VOID LockConnectionsList()
{ EnterCriticalSection(&m_csConnectionsList); }
VOID UnlockConnectionsList()
{ LeaveCriticalSection(&m_csConnectionsList); }
DWORD GetCurrentConnectionsCount( VOID) const
{ return m_cCurrentConnections; }
DWORD GetMaxCurrentConnectionsCount( VOID) const
{ return m_cMaxCurrentConnections; }
DWORD SetLocalHostName(IN LPCSTR pszHost);
LPCSTR QueryLocalHostName(VOID) const { return (m_pszLocalHostName); }
DWORD QueryUserFlags(VOID) const { return (m_dwUserFlags); }
BOOL QueryLowercaseFiles(VOID) const { return (m_fLowercaseFiles); }
BOOL AllowAnonymous(VOID) const { return (m_fAllowAnonymous); }
BOOL AllowGuestAccess(VOID) const { return (m_fAllowGuestAccess); }
BOOL IsAllowedUser(IN BOOL fAnonymous)
{
return ((fAnonymous && m_fAllowAnonymous) ||
(!fAnonymous && !m_fAllowAnonymous) ||
(!fAnonymous && !m_fAnonymousOnly));
}
BOOL IsEnablePortAttack(VOID) const { return (m_fEnablePortAttack); }
BOOL IsEnablePasvTheft(VOID) const { return (m_fEnablePasvTheft); };
DWORD NumListenBacklog(VOID) const { return (m_ListenBacklog); }
// Following functions return pointers to strings which should be used
// within locked sections of config
// Marked by LockConfig() and UnLockConfig()
LPCSTR QueryMaxClientsMsg(VOID) const
{ return (LPCSTR)m_MaxClientsMessage.QueryStr(); }
LPCSTR QueryGreetingMsg(VOID) const
{ return (LPCSTR)m_GreetingMessage.QueryStr(); }
LPCSTR QueryBannerMsg(VOID) const
{ return (LPCSTR)m_BannerMessage.QueryStr(); }
LPCSTR QueryExitMsg(VOID) const
{ return (LPCSTR)m_ExitMessage.QueryStr(); }
BOOL EnumerateConnection( IN PFN_CLIENT_CONNECTION_ENUM pfnConnEnum,
IN LPVOID pContext,
IN DWORD dwConnectionId);
VOID DisconnectAllConnections( VOID);
PICLIENT_CONNECTION
AllocNewConnection();
VOID RemoveConnection( IN OUT PICLIENT_CONNECTION pcc);
BOOL WriteParamsToRegistry( LPFTP_CONFIG_INFO pConfig );
VOID Print( VOID) const;
METADATA_REF_HANDLER* QueryMetaDataRefHandler() { return &m_rfAccessCheck; }
PTCP_AUTHENT_INFO QueryAuthentInfo() { return &m_TcpAuthentInfo; }
BOOL AllowReplaceOnRename( VOID ) const {
return m_fAllowReplaceOnRename;
}
LPFTP_SERVER_STATISTICS QueryStatsObj( VOID ) { return m_pFTPStats; }
ISOLATION_MODE QueryIsolationMode( VOID ) const {
return m_UserIsolationMode;
}
private:
//
// Connections related data
//
// m_cMaxConnections: max connections permitted by config
// m_cCurrentConnections: count of currently connected users
// m_cMaxCurrentConnections: max connections seen in this session
// Always m_cCurrentConnections
// <= m_cMaxCurrentConnections
// <= m_cMaxConnections;
//
// DWORD m_cMaxConnections;
// replaced by TSVC_INFO::QueryMaxConnections()
DWORD m_cCurrentConnections;
DWORD m_cMaxCurrentConnections;
BOOL m_fAllowAnonymous;
BOOL m_fAllowGuestAccess;
BOOL m_fAnnotateDirectories; // annotate dirs when dir changes
BOOL m_fAnonymousOnly;
BOOL m_fEnablePortAttack;
BOOL m_fEnablePasvTheft;
// if m_LowercaseFiles is TRUE, then dir listings from non-case-preserving
// filesystems will be mapped to lowercase.
BOOL m_fLowercaseFiles;
BOOL m_fMsdosDirOutput; // send msdos style dir listings
BOOL m_fFourDigitYear; // send 4 digit year dir listings
STR m_ExitMessage;
STR m_MaxClientsMessage;
TCP_AUTHENT_INFO m_TcpAuthentInfo;
//
// Greeting Message can be a multiline message.
// We maintain two copies of the message
// 1) double null terminated seq. of strings with one line per string
// 2) single null terminated string with \n characters interspersed.
//
// Representation 1 is used for sending data to clients
// Representation 2 is used for RPC admin facility
// We maintain the string as MULTI_SZ in the registry
//
MULTISZ m_GreetingMessage;
LPTSTR m_pszGreetingMessageWithLineFeed;
//
// Same as for the greeting message, the banner could be multiline too.
// Same handling.
//
MULTISZ m_BannerMessage;
LPTSTR m_pszBannerMessageWithLineFeed;
BOOL m_fEnableLicensing;
DWORD m_ListenBacklog;
CHAR * m_pszLocalHostName; // this machine name running ftp service
DWORD m_dwUserFlags; // user flags established at start of conn
//
// For FTP server configuration information
//
//
// TODO: merge configuration and instance object together
//
// LPFTP_SERVER_CONFIG m_pFtpServerConfig;
HKEY m_hkeyParams;
//
// Other data related to configuration load and store
//
BOOL m_fValid;
CRITICAL_SECTION m_csLock; // used for updating this object
CHAR m_rgchCacheBlock[MAX_CACHE_BLOCK_SIZE]; // to avoid false sharing
// we should avoid cache block conflict
// Following set of data constitute the dynamic data for connections
// ==> it will be good if they are closeby, within one cache block.
CRITICAL_SECTION m_csConnectionsList;
LIST_ENTRY m_ActiveConnectionsList; // list of all active connections
LIST_ENTRY m_FreeConnectionsList; // free list for connection objects
METADATA_REF_HANDLER m_rfAccessCheck;
LPFTP_SERVER_STATISTICS m_pFTPStats;
BOOL m_fAllowReplaceOnRename;
ISOLATION_MODE m_UserIsolationMode;
BOOL m_fLogInUtf8;
};
typedef FTP_SERVER_INSTANCE *PFTP_SERVER_INSTANCE;
#endif // _FTPINST_HXX_