home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / info / ntkb / ntkb.exe / Q102 / 9 / 74.TXT < prev    next >
Encoding:
Text File  |  1994-01-18  |  14.2 KB  |  360 lines
  1. DOCUMENT:Q102974  14-JAN-1994  [W_NT]
  2. TITLE   :REG: TCP/IP Transport Entries, PART 2
  3. PRODUCT :Windows NT
  4. PROD/VER:3.10
  5. OPER/SYS:WINDOWS
  6. KEYWORDS:
  7.  
  8. --------------------------------------------------------------
  9. The information in this article applies to:
  10.  
  11.  - Windows NT operating system version 3.1
  12.  - Windows NT Advanced Server version 3.1
  13.  
  14. The article contains REGISTRY entries for the TCP/IP Transport, Part 2.
  15. These subgroups are included:
  16.  
  17.  - FTP Server Service Entries for TCP/IP
  18.  - NBT Parameters for TCP/IP
  19.  - Streams Parameters for TCP/IP
  20.  - Windows Sockets Entries for TCP/IP
  21. --------------------------------------------------------------
  22.  
  23. This is the second of two articles on these entries; for the other
  24. entries, see "TCP/IP Transport Entries, Part 1."
  25.  
  26. TCP/IP TRANSPORT ENTRIES
  27. ========================
  28.  
  29. The various TCP/IP keys do not appear in the Registry unless TCP/IP is
  30. installed using the Network icon in Control Panel. With Registry Editor,
  31. you can modify the following parameters for the TCP/IP transport. This
  32. section does not include all the TCP/IP parameters that can be set using
  33. the Networks application in Control Panel.
  34.  
  35. The startup parameters defined in this section are found in these subkeys
  36. of HKEY_LOCAL_MACHINE\SYSTEM\System\CurrentControlSet\Services:
  37.  
  38.    TCPIP\Parameters
  39.    Adapter_name#\Parameters\TCPIP, (where adapter_name# indicates a
  40.                            Services subkey for a network adapter
  41.                            card)
  42.    Ftpsvc\Parameters
  43.    NBT\Parameters
  44.    Streams\Parameters
  45.  
  46. Parameters for network bindings for this service are described in the
  47. article "NetRules Subkey Entries." See also IsDomainMasterBrowser in the
  48. article "Browser Service Entries."
  49.  
  50. FTP SERVER SERVICE ENTRIES FOR TCP/IP
  51. =====================================
  52.  
  53. The following Registry path contains parameters that affect the behavior of
  54. the FTP server service component:
  55.  
  56.    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Ftpsvc\Parameters
  57.  
  58. The Ftpsvc subkey does not appear until you install the FTP service using
  59. the Network icon in Control Panel. Also, you must restart the FTP server
  60. service (Ftpsvc) using the Services icon in Control Panel for any changes
  61. to these values to take effect.
  62.  
  63. There can also be an AccessCheck subkey under Ftpsvc, which allows access
  64. to FTP for new users. If the AccessCheck subkey exists, but cannot be
  65. opened, the user is refused FTP services. If the subkey exists but can only
  66. be opened for read access, the user is granted read-only FTP access. If the
  67. subkey does not exist, it is not used to influence FTP access. By default,
  68. this subkey does not exist and therefore has no impact on FTP operations.
  69. An administrator can create this Registry subkey and attach specific access
  70. controls. which will serve to control user access to the FTP service.
  71.  
  72. AllowAnonymous   REG_DWORD   0 or 1
  73. -----------------------------------
  74. Default: 1 (true - anonymous logins are allowed)
  75.  
  76. Controls anonymous logins. Anonymous logins are only allowed if this value
  77. is non-zero (true).
  78.  
  79. AnnotateDirectories   REG_DWORD   0 or 1
  80. ----------------------------------------
  81. Default: 0 (false -do not send directory annotations)
  82.  
  83. When this value is 1, every time a user changes directories (that is, sends
  84. the server a CWD command), an attempt is made to open a file named
  85. ~FTPSVC~.CKM in the new directory. If this file is found, its contents are
  86. sent to the user as part of the successful reply to the CWD command. This
  87. may be used to attach annotations to specific directories. This value is
  88. used as a default for new users. Users can toggle their own personal
  89. annotate directories flag with the site-specific CKM command (SITE CKM).
  90.  
  91. AnonymousOnly   REG_DWORD   0 or 1
  92. ----------------------------------
  93. Default: 0 (false -non-anonymous logins are allowed)
  94.  
  95. When this value is 1, only anonymous logins are allowed. Otherwise, non-
  96. anonymous logins are allowed as well.
  97.  
  98. AnonymousUserName   REG_SZ   UserName
  99. -------------------------------------
  100. Default: "Guest"
  101.  
  102. Contains the anonymous login alias. When a user attempts an anonymous
  103. login, the username specified ("anonymous") is mapped to this Registry
  104. value for authentication and impersonation. The password for this account
  105. is stored in an LSA secret object named FTPD_ANONYMOUS_DATA.
  106.  
  107. ConnectionTimeout   REG_DWORD   Seconds
  108. ---------------------------------------
  109. Default: 600 (10 minutes)
  110.  
  111. Specifies the time to allow clients to remain idle before forcibly
  112. disconnecting them. This prevents idle clients from consuming server
  113. resources indefinitely. This value may be set to 0 if time-outs are not to
  114. be enforced. If set to 0, idle clients may remain connected indefinitely.
  115.  
  116. DebugFlags   REG_DWORD   BitFields
  117. ----------------------------------
  118. Default: 0 (no debug output)
  119.  
  120. Used only by the debugging (checked) builds of the FTP Server to control
  121. the output of various debugging information. This value is unused (and
  122. ignored) by retail builds.
  123.  
  124. ExitMessage   REG_SZ   Message
  125. ------------------------------
  126. Default: "Goodbye."
  127.  
  128. Specifies a signoff message sent to an FTP client upon receipt of a QUIT
  129. command.
  130.  
  131. GreetingMessage   REG_MULTI_SZ   Strings
  132. ----------------------------------------
  133. Default: None (no special greeting message)
  134.  
  135. Specifies the message (if this value exists in the Registry) to be sent to
  136. new clients after their account has been validated. In accordance with de
  137. facto Internet behaviour, if a client logs on as anonymous and specifies an
  138. identity starting with a '-' (minus), then this greeting message is not
  139. sent.
  140.  
  141. HomeDirectory   REG_EXPAND_SZ   Path
  142. ------------------------------------
  143. Default: C:\
  144.  
  145. Specifies the initial home directory for new clients. After a new client is
  146. validated, an attempt is made to change to this directory with the Chdir
  147. command. If this directory is inaccessible, the client is refused FTP
  148. services. If Chdir is successful, then an attempt is made to change to a
  149. directory with the same name as the clientÆs username. If this fails, an
  150. attempt is made to change to a directory called DEFAULT. If this fails, the
  151. current directory is left at home. If a new client connects and finds the
  152. home directory is inaccessible, an event is written to the event log.
  153.  
  154. LogAnonymous   REG_DWORD   0 or 1
  155. ---------------------------------
  156. Default: 0 (false -do not log successful anonymous logins)
  157.  
  158. When this value is 1, all successful anonymous logins are logged to the
  159. system event log.
  160.  
  161. LogNonAnonymous   REG_DWORD   0 or 1
  162. ------------------------------------
  163. Default: 0 (false, that is, do not log successful non-anonymous logins)
  164.  
  165. When this value is 1, all successful non-anonymous logins are logged to the
  166. system event log.
  167.  
  168. MaxClientsMessage   REG_SZ   Message
  169. ------------------------------------
  170. Default: "Maximum clients reached, service unavailable."
  171.  
  172. Specifies the message (if this value exists in the Registry) to be sent to
  173. a client if the maximum number of clients has been reached or exceeded.
  174. This indicates that the server is currently servicing the maximum number of
  175. simultaneous clients and is refusing additional clients. See
  176. MaxConnections.
  177.  
  178. MaxConnections   REG_DWORD   0 or 1
  179. -----------------------------------
  180. Default: 20
  181.  
  182. Specifies the maximum number of simultaneous clients the server will
  183. service. This value may be set to 0 if there is to be no limit on
  184. simultaneous clients.
  185.  
  186. MsdosDirOutput   REG_DWORD   0 or 1
  187. -----------------------------------
  188. Default: 1 (true-directory listings will look like MS-DOS)
  189.  
  190. When this value is 1, the output of the LIST command (usually sent as a
  191. result of a DIR command from the client) will look like the output of the
  192. MS-DOS dir command. If this value is 0, the output of the LIST command
  193. looks like the output of the Unix ls command.
  194.  
  195. This value also controls slash flipping in the path sent by the PWD
  196. command. When this value is 1 (true), the path contains backward slashes
  197. (\). If this value is 0 (false), the path contains forward slashes (/).
  198. This value is used as a default for new users. Users can toggle their own
  199. personal MS-DOS directory output flag with the site-specific DIRSTYLE
  200. command (SITE DIRSTYLE).
  201.  
  202. ReadAccessMask   REG_DWORD   BitFields
  203. --------------------------------------
  204. Default: 0 (all read access denied)
  205.  
  206. This value is a bitmask and controls the read ability of the various disk
  207. volumes in the system. Drive A corresponds to bit 0, drive B corresponds to
  208. bit 1, drive C corresponds to bit 2, and so on. A user may only read from a
  209. specific volume if the corresponding bit is set.
  210.  
  211. WriteAccessMask   REG_DWORD   BitFields
  212. ---------------------------------------
  213. Default: 0 (all write access denied)
  214.  
  215. This value is a bitmask and controls the write ability of the various disk
  216. volumes in the system. Drive A corresponds to bit 0, drive B corresponds to
  217. bit 1, drive C corresponds to bit 2, and so on. A user may only write to a
  218. specific volume if the corresponding bit is set.
  219.  
  220. NBT PARAMETERS FOR TCP/IP
  221. =========================
  222.  
  223. NBT is the NetBIOS over TCP/IP service. Parameters for TCP/IP are also
  224. configured under NBT in the following Registry path:
  225.  
  226.    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\NBT\Parameters
  227.  
  228. MaxPreload   REG_DWORD   Number
  229. -------------------------------
  230. Default: 100
  231.  
  232. Specifies the maximum NBT number of entries for LMHOSTS that are preloaded
  233. into the NBT NetBIOS name cache. LMHOSTS is a file located in the directory
  234. specified by DatabasePath.
  235.  
  236. NbProvider   REG_SZ   DLL name
  237. ------------------------------
  238. Default: _tcp
  239.  
  240. This value is only present for network services that provide a NetBIOS
  241. interface.  Its presence causes LanMan information to be maintained for the
  242. transport. The value data represents the RPC provider string used to select
  243. the proper DLL for interfacing RPC to the transport.
  244.  
  245. NbtKeepAlive   REG_DWORD   Number in seconds
  246. --------------------------------------------
  247. Default:  0 (Do not generate NBT keep-alive traffic.)
  248.  
  249. Specifies how often NBT will generate keep-alive traffic. When NBT
  250. determines that no activity has occurred on a connection for the specified
  251. time interval, it will generate keep-alive traffic to probe the connection.
  252. If TCP/IP is unable to deliver this traffic, it marks the connection as
  253. down and notifies NBT.
  254.  
  255. PermanentName   REG_SZ   Unique name
  256. ------------------------------------
  257. Default: The value of IPAddress in dotted decimal
  258.  
  259. Specifies the permanent name of the NetBIOS node for NBT. In many NetBIOS
  260. implementations, this is the MAC address. This name must be unique.
  261.  
  262. STREAMS PARAMETERS FOR TCP/IP
  263. =============================
  264.  
  265. The TCP/IP parameter for Streams are found under the following Registry
  266. path:
  267.  
  268.    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Streams\Parameters
  269.  
  270. MaxMemoryUsage   REG_DWORD   Number of bytes
  271. --------------------------------------------
  272. Default: No limit
  273.  
  274. Specifies the maximum amount of memory that can be allocated to the Streams
  275. environment. Once this limit is reached, Streams will fail allocation
  276. requests made by Streams-based drivers.
  277.  
  278. WINDOWS SOCKETS ENTRIES FOR TCP/IP
  279. ==================================
  280.  
  281. All Windows Sockets parameters can be set by choosing the Network icon in
  282. Control Panel. These parameters are found in two locations, as shown here.
  283.  
  284. HKEY_LOCAL_MACHINE\SYSTEM\
  285. CurrentControlSet\Services\Winsock\Parameters
  286. ---------------------------------------------
  287.  
  288. Transports   REG_Multi_SZ   Strings
  289. -----------------------------------
  290. Default: Depends on installation
  291.  
  292. Contains the Regisry key names of installed transports that support Windows
  293. Sockets. If TCP/IP is the only installed transport that supports Windows
  294. Sockets, then this value is Tcpip. The Windows Sockets DLL uses the strings
  295. in Transports to find information about each transport.
  296.  
  297. HKEY_LOCAL_MACHINE\SYSTEM\
  298. CurrentControlSet\Services\TCPIP\Parameters\Winsock
  299. ---------------------------------------------------
  300.  
  301. HelperDllName   REG_EXPAND_SZ   Path and filename
  302. -------------------------------------------------
  303. Default: Depends on the transport; %SystemRoot%\system32\wshtcpip.dll
  304. for TCP/IP.
  305.  
  306. Specifies the name of the Windows Sockets helper DLL for the TCP/IP
  307. transport. This value is set by the Windows Sockets DLL and is not a user
  308. settable parameter.
  309.  
  310. IRPStackSize   REG_DWORD   Number
  311. ---------------------------------
  312. Default: 4
  313.  
  314. Specifies the number of IRP stack locations needed by AFD, the driver used
  315. for Windows Sockets. The default is sufficient for all existing transports,
  316. but new transports may be developed that need more IRP stack locations.
  317.  
  318. Mapping   REG_BINARY
  319. --------------------
  320. Default:  Depends on transport
  321.  
  322. Identifies the address families, socket types, and protocols supported by
  323. the transport. This value is set by the Windows Sockets DLL and is not a
  324. user settable parameter.
  325.  
  326. MaxSockAddrLen   REG_DWORD   Octets
  327. -----------------------------------
  328.  
  329. Specifies the maximum length of socket addresses for the INET sockets
  330. family. This value is set by the Windows Sockets DLL and is not a user
  331. settable parameter.
  332.  
  333. MinSockAddrLen   REG_DWORD   Octets
  334. -----------------------------------
  335.  
  336. Specifies the minimum length of socket addresses for the INET sockets
  337. family. This value is set by the Windows Sockets DLL and is not a user
  338. settable parameter.
  339.  
  340. Reference: "The Windows NT Resource Kit for Operating System Version 3.1."
  341.  
  342. Additional reference words: 3.10
  343. KBCategory:
  344. KBSubCategory: KEYREG
  345.  
  346. =============================================================================
  347.  
  348. THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
  349. PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
  350. ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
  351. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
  352. EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
  353. ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
  354. CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
  355. MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
  356. POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
  357. OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
  358. SO THE FOREGOING LIMITATION MAY NOT APPLY.
  359.  
  360. Copyright Microsoft Corporation 1994.