home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 400s / rfc431.txt < prev   
Text File  |  1997-03-12  |  4KB  |  166 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. RFC #431                                       Mark Krilanovich
  8. NIC #13300                                     UCSB
  9. Updates:  122                                  Dec.  15, 1972
  10. Obsoletes:  399
  11.  
  12.                     Update on SMFS Login and Logout
  13.  
  14.        This document replaces RFC 399, which introduced the Login
  15. and Logout commands for UCSB's SMFS, but was incomplete.  RFC 399
  16. is restated here, followed by a description of the nature of the
  17. response elicted by these commands
  18.  
  19.        Two new commands have been added to UCSB's Simple Minded
  20. File System (SMFS).  They are described below.
  21.  
  22.        Login (LGI)
  23.        The Login command is the means whereby the user identifies
  24. himself and specifies the account number to which his use of SMFS
  25. is to be billed.  The user should issue a LGI command directly
  26. after completing the ICP and before any command referencing a
  27. file.  The user name and account number specified remain in
  28. effect until another LGI command is issued, a LGO command is
  29. issued, or the connection is close.
  30.  
  31.        At present, the use of SMFS is not billed, and therefore
  32. use of the accounting command is optional.  It is requested,
  33. however, that users and user processes begin to use this command
  34. as soon as possible, since we would like to collect statistics on
  35. SMFS utilization before implementing billing.  Therefore, at
  36. present the user name can be any name that identifies the user,
  37. and the account number is completely arbitrary.
  38.  
  39.        The format of the LGI command is given below.  Note that
  40. the lengths of the fixed-length fields are given in bits.  The op
  41. code for LGI is decimal 13.
  42.  
  43.            8
  44.        <op code><user name><account number>
  45.  
  46. The <user name> and <account number> fields are further divided
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                                                 [Page 1]
  59.  
  60. NWG/RFC #431                           MCK 15-DEC-72 12:39  13300
  61. Update on SMFS Login and Logout
  62.  
  63. as follows:
  64.  
  65.           8     8*length
  66.       <length><user name>
  67.  
  68. Where <length> gives the length in 8-bit characters of the <user
  69. name> or <account number> subfield.  The maximum length of <user
  70. name> is eight characters and of <account number> is four
  71. characters.  The <user name> and <account number> fields must
  72. consist of characters chosen from the same character set as
  73. filenames.
  74.  
  75.         Logout (LGO)
  76.        The logout command terminates the association between the
  77. user and the accounting information specified in the last LGI
  78. command issued, if any; it does not cause SMFS to close the
  79. connection.  The user should then issue another LGI command
  80. before attempting any operation referencing a file. It is not
  81. necessary to issue a LGO command before issuing another LGI
  82. command, or before closing the connection.
  83.  
  84.        Again, at the present time the LGO command is optional,
  85. and does not affect the user's ability to reference files.
  86.  
  87.        The format of the LGO command is as follows:
  88.  
  89.            8
  90.        <op code>
  91.  
  92. The op code for LGO is decimal 14.
  93.  
  94.         Login and logout each elicit, as their only response, an
  95. eight-bit completion code.  Like the other SMFS commands, the
  96. completion code is equal to the command's op code if the command
  97. was successful.  The following error completion codes, given in
  98. decimal, are currently defined:
  99.  
  100.  
  101.        47      The length of <user name> is zero.
  102.        48      <user name> is too long.
  103.        49      <user name> contains invalid characters.
  104.        50      The length of <account number> is zero.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                                                 [Page 2]
  112.  
  113. NWG/RFC# 431                           MCK 15-DEC-72 12:39 13300
  114. Update on SMFS Login and Logout
  115.  
  116.  
  117.        51      <account number> is too long.
  118.        52      <account number> contains invalid characters.
  119.        53      <user name) specifies an invalid user.
  120.        54      <account number> specifies an invalid account.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.        [ This RFC was put into machine readable form for entry ]
  133.        [ into the online RFC archives by BBN Corp. under the   ]
  134.        [ direction of Alex McKenzie.                      1/97 ]
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.                                                                 [Page 3]
  165.  
  166.