1 08/23/90  Kermit modes
  2 
  3 The following list of modes are recognized by the kermit file transfer
  4 protocol, and the kermit requests: set and show.   The values
  5 associated with each mode are also given.
  6 
  7 
  8 List of modes affecting file storage:
  9 file_type STR
 10    indicates the type of file being transferred.  STR may be one of
 11    "binary" or "ascii".
 12 file_warning STR
 13    indicates the action to be taken when an incoming file name has
 14    the same name as an existing file name in the default directory
 15    when receiving files.  STR may be one of "on" or "off".  If
 16    file_warning is on, kermit will rename the file to avoid
 17    overwriting the pre-existing one.  If file_warning is off the
 18    incoming file will replace the pre-existing one.  If logging
 19    transactions, the log will indicate the name of the file in which
 20    the data was stored.  Default is on.
 21 
 22 
 23 
 24 incomplete STR
 25    indicates the action to be taken if a file was not completely
 26    transferred.  STR may be one of "keep" or "discard".  If keep is
 27    specified, all incomplete files are saved.  If discard is
 28    specified, incomplete files will be discarded.  (Default is
 29    keep.)
 30 
 31 
 32 List of modes affecting file transfer:
 33 control_prefix CHR, cp CHR
 34    the character to use for quoting of control characters, where CHR
 35    is any character in the range "!" through ">" or "`" through "~",
 36    but different from the eight_bit_prefix and repeat_prefix.
 37    (Default is #)
 38 
 39 
 40 eight_bit_prefix CHR, ebp CHR
 41    the ascii character Multics-Kermit will use to quote characters
 42    which have the 8th bit set, when transmitting binary files via a
 43    7-bit connection.  CHR is one of the following, but
 44    different from the control_prefix and repeat_prefix:
 45 
 46    Y characters with the 8th bit set will be quoted if the remote
 47      Kermit requests it.
 48 
 49    N Characters with the 8th bit set will not be quoted.
 50 
 51 
 52    & or any character in the range "!" through ">" or "`" through
 53      "~".  Use the specified character for quoting characters with the
 54      8th bit set.  If the Multics-Kermit eight_bit_prefix character is
 55      different from the remote kermit's, then no 8th bit prefixing
 56      will be done.
 57 
 58    The value of this mode is ignored if line_byte_size is 8.
 59    (Default is &)
 60 
 61 
 62 end_of_packet CHR, eop CHR
 63    the character Multics-Kermit will use as a line terminator for
 64    incoming packets, where CHR is an ascii character between SOH (001
 65    octal) and US (037 octal) inclusive, and different from the
 66    start_of_packet character.  (Default is carriage return,
 67    015 octal)
 68 
 69 
 70 line_byte_size N
 71    indicates whether data is being transmitted via a 7-bit or 8-bit
 72    connection, where N may be one of 7 or 8.
 73    A 7-bit connection is desirable when transferring ascii
 74    files, or when the 8th bit of each transmitted byte is
 75    required for parity or changed by intervening communications
 76    equipment.  An 8-bit connection should be used for transferring
 77    binary files as it decreases protocol overhead.  If an 8-bit
 78    connection cannot be used for a binary file transfer, then a 7-bit
 79    connection with the eight_bit_prefix mode enabled may be used to
 80    transfer binary files (See above).  (Default is 7)
 81 
 82 packet_length N, pl N
 83    maximum packet length Multics-Kermit will receive, where N is an
 84    integer between 20 and 94 (decimal).  (Default is 80)
 85 
 86 
 87    NOTE: Long packets can be selected when the user has explicitly
 88    selected N which is larger than 94 with a SET command.  The maximum
 89    length of long packets can be up to 1500 characters.
 90 
 91 parity STR
 92    used for communicating with systems or networks that require the
 93    8th bit for character parity.  The parity used must be the same
 94    for both the local and remote kermit.  STR may be one of:
 95 
 96           "none"    eight data bits and no parity.
 97           "mark"    seven data bits with the parity bit set to
 98                     one.
 99           "space"   seven data bits with the parity bit set to
100                     zero.
101 
102 
103           "even"    seven data bits with the parity bit set to
104                     make the overall parity even.
105           "odd"     seven data bits with the parity bit set to
106                     one to make the overall parity odd.
107 
108    The value of the mode is ignored if line_byte_size is 8.
109    (Default is none)
110 
111 
112 repeat_prefix CHR, rp CHR
113    the character Multics-Kermit will use to indicate a repeated
114    character, where CHR may be any character in the range "!" through
115    ">" or "`" through "~", but different from the control_prefix and
116    eight_bit_prefix.  Space " " denotes no repeat count processing is
117    to be done.  If the Multics-Kermit repeat_prefix character is
118    different from the remote kermit's, then no repeat prefixing will
119    be done.  (Default is "~").
120 retry_threshold N, rt N
121    how many times to try sending or receiving a particular packet
122    before giving up, where N is an integer between 5 and 15
123    inclusive.  (Default is 5)
124 
125 
126 start_of_packet CHR, sop CHR
127    the character to be used for the start of packet, where
128    CHR is an ascii character between NUL (000 octal) and US (037
129    octal) inclusive.  The start_of_packet character must be the same
130    for both the local and remote kermit, but different from the
131    end_of_packet character.  (Default is SOH, octal 001)
132 timeout N
133    how many seconds Multics-Kermit wants the remote Kermit to wait
134    for a packet from Multics before trying again, where N is an
135    integer value between 5 and 20.  (Default is 15)