home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FS132_MA.ZIP / CONFIG.MAN < prev    next >
Encoding:
Text File  |  1993-05-05  |  9.8 KB  |  274 lines
  1. .se Support Files
  2. .vm 1
  3. .vi 3
  4. .rl 2
  5. .da 07 May, 1993
  6. .ss fsuucp.cfg configuration file ([basedir]\fsuucp.cfg) 
  7. .sa escape
  8.  
  9. This file controls execution of FSUUCP. Lines consist of a control variable
  10. and a value, seperated by whitespace (space or tab). This file will be 
  11. created and set up by the installer.  After creating this file, the 
  12. installer will place it in the base directory, along with the rest of the 
  13. executables.
  14.  
  15. YOU MUST HAVE AN ENVIRONMENT VARIABLE, "FSUUCP," WHICH CONTAINS THE
  16. DIRECTORY WHICH CONTAINS THIS FILE.
  17.  
  18. Following is a list of the fields in the FSUUCP.CFG file. Most are
  19. mandatory, and some are completed by the installer. They all may,
  20. of course, be changed at any time.
  21.  
  22. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  23.  
  24. Field: sysname
  25.  
  26. Use: The full domainized name of your site. If you do not have a domain name, 
  27.      the psuedo-domain .UUCP may be used, though it is discouraged, as most
  28.      mailers will not understand it. It is highly recommended that you
  29.      obtain a domain name. The .us domain set is free for the asking.
  30.  
  31. Example: sysname vogonsys.space.big.com
  32.          sysname vogonsys.UUCP
  33.  
  34. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  35.  
  36. Field: logname
  37.  
  38. Use: The standard UUCP site name. This is the name that other machines 
  39.      recognize your machine by.
  40.  
  41. Example: logname vogonsys
  42.  
  43. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  44.  
  45. Field: username
  46.  
  47. Use: The name of the user currently using the FSUUCP session. This determines 
  48.      which mailbox to use, as well as which return paths are returned by mail 
  49.      and news. Note that the value of the environment variable USER will 
  50.      override this setting.
  51.  
  52. Example: user zaphod
  53.  
  54. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  55.  
  56. Field: fullname
  57.  
  58. Use: The string that is printed in both mail and news headers to identify a 
  59.      user. Note that the value of the environment variable NAME will override 
  60.      this setting.
  61.  
  62. Example: name Zaphod Beebelbrox
  63.  
  64. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  65.  
  66. Field: spool
  67.  
  68. Use: This is the base path for the spool directory. The spool directory holds
  69.      the data and control files for mail and news that are waiting for
  70.      transfer, as well as incoming data. It is recommended that the spool
  71.      directory be located on a disk with plenty of space and decent response
  72.      time.
  73.  
  74. Example: spool c:\fsuucp\spool
  75.  
  76. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  77.  
  78. Field: logfile
  79.  
  80. Use: This is the name for the UUCP logging file. Note that this field
  81.      contains a complete file name, and not just a directory as in other
  82.      fields. FSUUCP generates log files that are even uglier than UNIX(tm) 
  83.      log files, but there is useful information in them for debugging purposes 
  84.      and feed testing. You will want to watch the size of this file and prune 
  85.      it occasionally.
  86.  
  87. Example: logfile c:\fsuucp\spool\uucp\logfile
  88.  
  89. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  90.  
  91. Field: organization
  92.  
  93. Use: This is the organization field which is printed in Usenet message headers
  94.  
  95. Example: organization Dr. Ho's Secret Laboratory and Daycare Centre
  96.  
  97. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  98.  
  99. Field: smarthost
  100.  
  101. Use: This is a valid UUCP bang-path to your nearest or most trusted smarthost.
  102.      At this time, FSUUCP does not support domainized mailing by itself. If
  103.      a mail path is generated that FSUUCP does not understand, it will punt
  104.      the message off to this site, hoping it can make sense of it. Be sure 
  105.      that the first name in the smarthost field is a system to which you 
  106.      connect directly, and that it is mentioned in your SYSTEMS file.
  107.  
  108. Example: smarthost foo!bar!ucbvax
  109.  
  110. In this example, mail to "spock@enterprise.ufp.com" would be mailed as
  111. "foo!bar!ucbvax!spock@enterprise.ufp.com", parsing from left to right.
  112. (That is, it would be sent to "foo").
  113.  
  114. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  115.  
  116. Field: libdir
  117.  
  118. Use: This is the base path for the LIB directory. Within LIB are the control
  119.      directories for UUCP and NEWS.
  120.  
  121. Example: libdir c:\fsuucp\lib
  122.  
  123. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  124.  
  125. Field: home
  126.  
  127. Use: This is the directory under which each user will have a home directory
  128.      for storing a mailrc, sig, and newsrc file, as well as any system
  129.      generated files specific to the user.
  130.  
  131. Example: home c:\fsuucp\home
  132.  
  133. NOTE: There has been confusion as to where user directories must be created. 
  134.       The answer is under home, and only under home. You do not need to create 
  135.       user directories in spool/mail. Doing so will, in fact, prohibit mail 
  136.       from being delivered.
  137.  
  138. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  139.  
  140. Field: pubdir
  141.  
  142. Use: This is the path name for the directory which holds all files that are
  143.      neither mail nor news.  This path is being implemented and reserved 
  144.      for future use.
  145.  
  146. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  147.  
  148. Field: news
  149.  
  150. Use: This is the base path for the Usenet news directory. All newsgroup
  151.      storage areas are based off of this path. The installer will also create 
  152.      [news]\outgoing, for outgoing batch files.
  153.  
  154. Example: news c:\fsuucp\news
  155.  
  156. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  157.  
  158. Field: port
  159.  
  160. Use: This is the COM port to use. 1 is equivilant to COM1, 2 is COM2, etc.
  161.  
  162. Example: port 1
  163.  
  164. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  165.  
  166. Field: modem
  167.  
  168. Use: This is a filename, which contains modem configuration information.
  169.      See the help file on MODEM for information about the internals of
  170.      the modem configuration file.
  171.  
  172. Example: modem c:\fsuucp\modems\telebit.mdm
  173.  
  174. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  175.  
  176. Field: editor
  177.  
  178. Use: This is the switch for determining which editor to use. FSUUCP has an
  179.      internal line editor, or allows you to specify your own. If you
  180.      specify the line editor, you may still enter the visual editor with
  181.      the proper escape code from within the line editor.
  182.  
  183. Example: editor line
  184. Example: editor visual
  185.  
  186. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  187.  
  188. Field: visual
  189.  
  190. Use: This specifies an executable file name for visual editing. This file
  191.      will be called if the EDITOR field is set to "visual," or you shell
  192.      to a visual editor from within the line editor. The editor specified
  193.      must be able to accept a file name as a sole argument, and not
  194.      change the name of the final edited file.
  195.  
  196. Example: visual c:\fsuucp\bin\vi.exe
  197.  
  198. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  199.  
  200. Field: ramdisk
  201.  
  202. Use: If this optional field is placed in the fsuucp.cfg file, then all
  203.      temporary storage will use the root directory of the drive specified.
  204.      If no ramdisk is used, then temporary storage will use the path
  205.      [spool]\uucp\tmp for all temporary files.
  206.  
  207. Example: ramdisk e
  208.  
  209. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  210.  
  211. Field: serveralias
  212.  
  213. Use: This optional field allows a remote machine to store files with
  214.      server-dependent drive specifications in them. This is used by
  215.      batcher.exe to correctly access news articles for batching.
  216.      For example, if a network is running such that the remote machine 
  217.      references the server's c: drive as f:, this field allows batcher to 
  218.      run using the correct reference (c:).
  219.  
  220.      In this example, any references in a batch file in [news]/outgoing
  221.      for any drive letter will be changed to c. This unconditional
  222.      mapping allows multiple workstations to map the server's news spool
  223.      to any letter, and allow the server to correctly access the articles.
  224.  
  225. Example : serveralias c
  226.  
  227. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  228.  
  229. Field: autosig
  230.  
  231. Use: This field controls the status of the automatic appending of 
  232.      signature files to mail messages.  The default setting is always
  233.      off. If you set it on, your signature ([home]\[user]\sig) will be
  234.      appended to your outgoing mail messages.
  235.  
  236.      Signatures are automatically appended to news articles if a sig file
  237.      exsts.
  238.  
  239. Example: autosig on
  240.  
  241. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  242.  
  243.   Timeouts
  244.   --------
  245.  
  246.     FSUUCP now supports 3 levels of timeouts in UUCICO.
  247.  
  248.     Field: tcd  - Timeout waiting for carrier from remote site
  249.  
  250.       For multiprotocol modems, like Telebits, you may have to set
  251.       this pretty high, sometimes even as high as 90 seconds. Make 
  252.       sure that your modem register controlling how long the modem
  253.       waits for carrier is at least as long as this variable.
  254.  
  255.     Field: tlogin - Timeout while executing login script from SYSTEMS file
  256.  
  257.       On the average, 15 to 20 seconds is a good value here.
  258.  
  259.     Field: tdata  - Timeout while executing protocol transfer
  260.  
  261.       Since UUCICO will retry up to 10 times on bad data, 5 to 10
  262.       seconds is a good average here. Your remote site may be slower
  263.       or faster.
  264.  
  265. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  266.  
  267. Field: attribution
  268.  
  269. Use: This field allows you to create the format for the "attribution"
  270.      line in news messages using the percent escape codes. See the manual
  271.      page ESCAPE for a list of valid % codes.
  272.  
  273. Example: attribution In article %i, %f writes:
  274.