#
# File: /etc/uucp/port
#	==============
# 
# Example by Andreas Klemm <andreas@knobel.knirsch.de>
#
# Based on Taylor uucp documentation 1.04
#
# Sat Jan  8 15:19:18 GMT+0100 1994
#
# Description:
# -----------
#
# The default is the file `port' in the directory /etc/uucp. The file 
# describes ports which are used to call other systems and accept 
# calls from other systems.
#

################################################################################
#
# First Modem "modem_1"
#
################################################################################

#
# Name of the Modem Port
#

port modem_1

#
# Port Type
#
# - `modem'  For a modem hookup.
# - `stdin'  For a connection through standard input and standard output,
#                as when `uucico' is run as a login shell.
# - `direct' For a direct connection to another system.
# - `tcp'    For a connection using TCP.
# - `tli'    For a connection using TLI.
#

type modem

#
# The Device the modem is connected to (full pathname)
#

device /dev/cua1

#
# `speed NUMBER [modem and direct only ]'
#    The speed this port runs at.  If a system specifies a speed but no
#    port name, then all ports which match the speed will be tried in
#    order.  If the speed is not specified here and is not specified by
#    the system, the natural speed of the port will be used by default.
#
# note: if you have a high speed modem that can "CONNECT 14400" or above
#	it's a good idea to select a baud rate over the connect rate !
#	For a 14400 Baud Modem for example 19200 or 38400 Baud.
#
#	If you don't have high quality serial cards with a 16550 Chip
#	you shouldn't choose more than 19200 Baud !
#
# and:	Use short cables between Modem and computer when transferring
#	with higher speeds ! 10 Meters are too large. 3 Meters should
#	be ok. Make your own experiences, but be warned ! ;-)
#

speed 19200

#
# `speed-range NUMBER NUMBER [ modem only ]'
#     Specify a range of speeds this port can run at.  The first number
#     is the minimum speed, the second number is the maximum speed.
#     These numbers will be used when matching a system which specifies
#     a desired speed. The simple `speed' (or `baud') command is still
#     used to determine the speed to run at if the system does not
#     specify a speed. For example, the command `speed-range 300 19200'
#     means that the port will match any system which uses a speed from
#     300 to 19200 baud (and will use the speed specified by the                    
#

speed-range 1200 19200

#
# which dialer to use (see file /etc/uucp/dial)
#

dialer hayes

#
# Half duplex mode for Trailblazers in PEP mode and i-proto
#
#
# half-duplex true
#

half-duplex false

#
# `reliable BOOLEAN [ any type ]'
#    This is only used during protocol negotiation; if the argument is
#    false, it forces the selection of a protocol which works across an
#    unreliable communication link.  The default is true.  It would be
#    more common to specify this for a dialer rather than a port.
#

reliable true

#
# Protocoll selection for this port
#
# The `t' and `e' protocols are intended for use over TCP or some
# other communication path with end to end reliability, as they do no
# checking of the data at all.  They will only be considered on a
# TCP port which is both reliable and eight bit.
#
# The `i' protocol is a bidirectional protocol.  It requires an
# eight-bit connection.  It will run over a half-duplex link, such as
# Telebit modems in PEP mode, but for efficient use of such a
# connection you must use the `half-duplex' command
#
# The `g' protocol is robust, but requires an eight-bit connection.
#
# The `G' protocol is the System V Release 4 version of the `g'
# protocol.
#
# The `a' protocol is a Zmodem like protocol, contributed by Doug
# Evans.  It requires an eight-bit connection, but unlike the `g' or
# `i' protocol it will work if certain control characters may not be
# transmitted.
#
# The `j' protocol is a variant of the `i' protocol which can avoid
# certain control characters.  The set of characters it avoids can
# be set by a parameter.  While it technically does not require an
# eight bit connection (it could be configured to avoid all
# characters with the high bit set) it would be very inefficient to
# use it over one.  It is useful over a eight-bit connection that
# will not transmit certain control characters.
#
# The `f' protocol is intended for use with X.25 connections; it
# checksums each file as a whole, so any error causes the entire
# file to be retransmitted.  It requires a reliable connection, but
# only uses seven-bit transmissions.  It is a streaming protocol,
# so, while it can be used on a serial port, the port must be
#  completely reliable and flow controlled; many aren't.
#
#
# Note: the default for t-uucp is to try to make i protocol connections.
#	when the other site has t-uucp, too. This proto works with large
#	window and package sizes (14,1024)
#
# 	Since I have noisy telephone lines to my mail and newsfeed
#	I prefer using the g-proto, which seems to be more robust !
#	
#	If you have trouble using i-Proto, try to use the following
#	entry:
#
# protocol gGia


################################################################################ 
#
# Protocol Parameter section (EXPERTS ONLY)
#
# usually you don't need to change anything
#
################################################################################ 
#
# Note, that some parameters can only be changed
# successfully, if your uucp neighbor has Taylor UUCP, too !!!!
#
# `protocol-parameter CHARACTER STRING ...'
#      CHARACTER is a single character specifying a protocol.  The
#      remaining strings are a command specific to that protocol which
#      will be executed if that protocol is used.  A typical command is
#      something like `window 7'.  The particular commands are protocol
#      specific.
#
################################################################################ 


################################################################################ 
#
#      The `i' protocol supports the following commands, all of which take
#      numeric arguments:
#
################################################################################ 
# 
#     `window'
#           The window size to request the remote system to use.  This
#           must be between 1 and 31 inclusive.  The default is 16.
# 
#     `packet-size'
#           The packet size to request the remote system to use.  This
#           must be between 1 and 4095 inclusive.  The default is 1024.
# 
#     `remote-window'
#           If this is between 1 and 31 inclusive, the window size
#           requested by the remote system is ignored and this is used
#           instead.  The default is 0, which means that the remote
#           system's request is honored.                           
# 
#     `remote-packet-size'
#           If this is between 1 and 4095 inclusive, the packet size
#           requested by the remote system is ignored and this is used
#           instead.  The default is 0, which means that the remote
#           system's request is honored.
# 
#     `sync-timeout'
#           The length of time, in seconds, to wait for a SYNC packet
#           from the remote system.  SYNC packets are exchanged when the
#           protocol is started.  The default is 10.
# 
#     `sync-retries'
#           The number of times to retry sending a SYNC packet before
#           giving up. The default is 6.
#
#     `timeout'
#           The length of time, in seconds, to wait for an incoming
#           packet before sending a negative acknowledgement.  The
#           default is 10.
# 
#     `retries'
#           The number of times to retry sending a packet or a negative
#           acknowledgement before giving up and closing the connection.
#           The default is 6.
# 
#     `errors'
#           The maximum number of errors to permit before closing the
#           connection. The default is 100.
# 
#     `error-decay'
#           The rate at which to ignore errors.  Each time this many
#           packets are received, the error count is decreased by one, so
#           that a long connection with an occasional error will not
#           exceed the limit set by `errors'. The default is 10.
#

################################################################################ 
# 
#      The `g' and `G' protocols support the following commands, all of
#      which take numeric arguments, except `short-packets' which takes a
#      boolean argument:
#
################################################################################ 
#                                                                                           
# 
#     `window'
#           The window size to request the remote system to use.  This
#           must be between 1 and 7 inclusive.  The default is 7.
# 
#     `packet-size'
#           The packet size to request the remote system to use.  This
#           must be a power of 2 between 32 and 4096 inclusive.  The
#           default is 64, which is the only packet size supported by
#           many older UUCP packages.  Some UUCP packages will even dump
#           core if a larger packet size is requested.
#     `startup-retries'
#           The number of times to retry the initialization sequence.
#           The default is 8.
# 
#     `init-retries'
#           The number of times to retry one phase of the initialization
#           sequence (there are three phases).  The default is 4.
# 
#     `init-timeout'
#           The timeout in seconds for one phase of the initialization
#           sequence.  The default is 10.
# 
#     `retries'
#           The number of times to retry sending either a data packet or
#           a request for the next packet.  The default is 6.
# 
#     `timeout'
#           The timeout in seconds when waiting for either a data packet
#           or an acknowledgement.  The default is 10.
# 
#     `garbage'
#           The number of unrecognized bytes to permit before dropping the
#           connection.  This must be larger than the packet size.  The
#           default is 10000.
# 
#     `errors'
#           The number of errors (malformed packets, out of order
#           packets, bad checksums, or packets rejected by the remote    
#           system) to permit before dropping the connection.  The
#           default is 100.
# 
#     `error-decay'
#           The rate at which to ignore errors.  Each time this many
#           packets are received, the error count is decreased by one, so
#           that a long connection with an occasional error will not
#           exceed the limit set by `errors'. The default is 10.
#
#     `remote-window'
#           If this is between 1 and 7 inclusive, the window size
#           requested by the remote system is ignored and this is used
#           instead.  This can be useful when dealing with some poor UUCP
#           packages.  The default is 0, which means that the remote
#           system's request is honored.
# 
#     `remote-packet-size'
#           If this is between 32 and 4096 inclusive the packet size
#           requested by the remote system is ignored and this is used
#           instead.  There is probably no good reason to use this.  The
#           default is 0, which means that the remote system's request is
#           honored.
# 
#     `short-packets'
#           If this is true, then the code will optimize by sending
#           shorter packets when there is less data to send.  This
#           confuses some UUCP packages, such as System V Release 4 (when
#           using the `G' protocol) and Waffle; when connecting to such a
#           package, this parameter must be set to false. The default is 
#           true for the `g' protocol and false for the `G' protocol.
# 

protocol-parameter g window 7
protocol-parameter g remote-window 7
protocol-parameter g packet-size 128
protocol-parameter g remote-packet-size 128
protocol-parameter g retries 10
protocol-parameter g timeout 20
protocol-parameter g short-packets true

# protocol-parameter G window 7
# protocol-parameter G remote-window 7
# protocol-parameter G packet-size 1024
# protocol-parameter G remote-packet-size 1024
# protocol-parameter G retries 10
# protocol-parameter G timeout 20
# protocol-parameter G short-packets true


################################################################################ 
#
#      The `a' protocol is a Zmodem like protocol contributed by Doug
#      Evans.  It supports the following commands, all of which take
#      numeric arguments except for `escape-control', which takes a
#      boolean argument:
#
################################################################################ 
# 
#     `timeout'
#           Number of seconds to wait for a packet to arrive.  The
#           default is 10.
# 
#     `retries'
#           The number of times to retry sending a packet.  The default
#           is 10.
#
#     `startup-retries'
#           The number of times to retry sending the initialization
#           packet.  The default is 4.
# 
#     `garbage'
#           The number of garbage characters to accept before closing the
#           connection.  The default is 2400.
# 
#     `send-window'
#           The number of characters that may be sent before waiting for
#           an acknowledgement.  The default is 1024.
# 
#     `escape-control'
#           Whether to escape control characters.  If this is true, the
#           protocol may be used over a connection which does not
#           transmit certain control characters, such as `XON' or `XOFF'.
#            The connection must still transmit eight bit characters
#           other than control characters.  The default is false.
#

################################################################################ 
#
#      The `j' protocol can be used over an eight bit connection that will
#      not transmit certain control characters.  It accepts the same
#      protocol parameters that the `i' protocol accepts, as well as one
#      more:
#
################################################################################ 
# 
#     `avoid'
#           A list of characters to avoid.  This is a string which is
#           interpreted as an escape sequence (*note Chat Scripts::.).
#           The protocol does not have a way to avoid printable ASCII
#           characters (byte values from 32 to 126, inclusive); only
#           ASCII control characters and eight-bit characters may be
#           avoided.  The default value is `\021\023'; these are the
#           characters `XON' and `XOFF' which many connections use for
#           flow control.  If the package is configured to use
#           `HAVE_BSD_TTY', then on some versions of Unix you may have to
#           avoid `\377' as well, due to the way some implementations of
#           the BSD terminal driver handle signals.
#

################################################################################ 
#
#      The `f' protocol is intended for use with error-correcting modems
#      only; it checksums each file as a whole, so any error causes the
#      entire file to be retransmitted.  It supports the following
#      commands, both of which take numeric arguments:
#
################################################################################ 
# 
#     `timeout'
#           The timeout in seconds before giving up.  The default is 120.
# 
#     `retries'
#           How many times to retry sending a file.  The default is 2.
# 


################################################################################ 
#
#      The `t' and `e' protocols are intended for use over TCP or some
#      other communication path with end to end reliability, as they do no
#      checking of the data at all.  They both support a single command,
#      which takes a numeric argument:
#
################################################################################ 
# 
#     `timeout'
#           The timeout in seconds before giving up.  The default is 120.
# 
#      The protocol parameters are reset to their default values after
#      each call.
# 
# 

##### End of protocol parameter section #####################
