Return to cu.1 CVS log

Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104

Annotation of coherent/g/usr/lib/uucp/tay104/cu.1, revision 1.1

1.1     ! root        1: ''' $Id: cu.1,v 1.1 93/07/30 07:52:59 bin Exp Locker: bin $
        !             2: .TH cu 1 "Taylor UUCP 1.04"
        !             3: .SH NAME
        !             4: cu \- Call up another system
        !             5: .SH SYNOPSIS
        !             6: .B cu
        !             7: [ options ] [ system | phone | "dir" ]
        !             8: .SH DESCRIPTION
        !             9: The
        !            10: .I cu
        !            11: command is used to call up another system and act as a dial in
        !            12: terminal.  It can also do simple file transfers with no error
        !            13: checking.
        !            14: 
        !            15: .I cu
        !            16: takes a single argument, besides the options.  If the argument is the
        !            17: string "dir" cu will make a direct connection to the port.  This may
        !            18: only be used by users with write access to the port, as it permits
        !            19: reprogramming the modem.
        !            20: 
        !            21: Otherwise, if the argument begins with a digit, it is taken to be a
        !            22: phone number to call.  Otherwise, it is taken to be the name of a
        !            23: system to call.  The
        !            24: .B \-z
        !            25: option may be used to name a system beginning with a digit, and the
        !            26: .B \-c
        !            27: option may be used to name a phone number that does not begin with a
        !            28: digit.
        !            29: 
        !            30: .I cu
        !            31: locates a port to use in the UUCP configuration files.  If a simple
        !            32: system name is given, it will select a port appropriate for that
        !            33: system.  The
        !            34: .B \-p, \-l
        !            35: and
        !            36: .B \-s
        !            37: options may be used to control the port selection.
        !            38: 
        !            39: When a connection is made to the remote system,
        !            40: .I cu
        !            41: forks into two processes.  One reads from the port and writes to the
        !            42: terminal, while the other reads from the terminal and writes to the
        !            43: port.
        !            44: 
        !            45: .I cu
        !            46: provides several commands that may be used during the conversation.
        !            47: The commands all begin with an escape character, initially
        !            48: .B ~
        !            49: (tilde).  The escape character is only recognized at the beginning of
        !            50: a line.  To send an escape character to the remote system at the start
        !            51: of a line, it must be entered twice.  All commands are either a single
        !            52: character or a word beginning with
        !            53: .B %
        !            54: (percent sign).
        !            55: 
        !            56: .I cu
        !            57: recognizes the following commands:
        !            58: 
        !            59: .TP 5
        !            60: .B ~.
        !            61: Terminate the conversation.
        !            62: .TP 5
        !            63: .B ~! command
        !            64: Run command in a shell.  If command is empty, starts up a shell.
        !            65: .TP 5
        !            66: .B ~$ command
        !            67: Run command, sending the standard output to the remote system.
        !            68: .TP 5
        !            69: .B ~| command
        !            70: Run command, taking the standard input from the remote system.
        !            71: .TP 5
        !            72: .B ~+ command
        !            73: Run command, taking the standard input from the remote system and
        !            74: sending the standard output to the remote system.
        !            75: .TP 5
        !            76: .B ~#, ~%break
        !            77: Send a break signal, if possible.
        !            78: .TP 5
        !            79: .B ~c directory, ~%cd directory
        !            80: Change the local directory.
        !            81: .TP 5
        !            82: .B ~> file
        !            83: Send a file to the remote system.  This just dumps the file over the
        !            84: communication line.  It is assumed that the remote system is expecting
        !            85: it.
        !            86: .TP 5
        !            87: .B ~<
        !            88: Receive a file from the remote system.  This prompts for the local
        !            89: file name and for the remote command to execute to begin the file
        !            90: transfer.  It continues accepting data until the contents of the
        !            91: .B eofread
        !            92: variable are seen.
        !            93: .TP 5
        !            94: .B ~p from to, ~%put from to
        !            95: Send a file to a remote Unix system.  This runs the appropriate
        !            96: commands on the remote system.
        !            97: .TP 5
        !            98: .B ~t from to, ~%take from to
        !            99: Retrieve a file from a remote Unix system.  This runs the appropriate
        !           100: commands on the remote system.
        !           101: .TP 5
        !           102: .B ~s variable value
        !           103: Set a
        !           104: .I cu
        !           105: variable to the given value.  If value is not given, the variable is
        !           106: set to
        !           107: .B true.
        !           108: .TP 5
        !           109: .B ~! variable
        !           110: Set a
        !           111: .I cu
        !           112: variable to
        !           113: .B false.
        !           114: .TP 5
        !           115: .B ~z
        !           116: Suspend the cu session.  This is only supported on some systems.  On
        !           117: systems for which ^Z may be used to suspend a job, 
        !           118: .B ~^Z
        !           119: will also suspend the session.
        !           120: .TP 5
        !           121: .B ~%nostop
        !           122: Turn off XON/XOFF handling.
        !           123: .TP 5
        !           124: .B ~%stop
        !           125: Turn on XON/XOFF handling.
        !           126: .TP 5
        !           127: .B ~v
        !           128: List all the variables and their values.
        !           129: .TP 5
        !           130: .B ~?
        !           131: List all commands.
        !           132: 
        !           133: .I cu
        !           134: also supports several variables.  They may be listed with the
        !           135: .B ~v
        !           136: command, and set with the
        !           137: .B ~s
        !           138: or
        !           139: .B ~!
        !           140: commands.
        !           141: 
        !           142: .TP 5
        !           143: .B escape
        !           144: The escape character.  Initially
        !           145: .B ~
        !           146: (tilde).
        !           147: .TP 5
        !           148: .B delay
        !           149: If this variable is true,
        !           150: .I cu
        !           151: will delay for a second after recognizing the escape character before
        !           152: printing the name of the local system.  The default is true.
        !           153: .TP 5
        !           154: .B eol
        !           155: The list of characters which are considered to finish a line.  The
        !           156: escape character is only recognized after one of these is seen.  The
        !           157: default is carriage return, ^U, ^C, ^O, ^D, ^S, ^Q, ^R.
        !           158: .TP 5
        !           159: .B binary
        !           160: Whether to transfer binary data when sending a file.  If this is
        !           161: false, then newlines in the file being sent are converted to carriage
        !           162: returns.  The default is false.
        !           163: .TP 5
        !           164: .B binary-prefix
        !           165: A string used before sending a binary character in a file transfer, if
        !           166: the
        !           167: .B binary
        !           168: variable is true.  The default is ^Z.
        !           169: .TP 5
        !           170: .B echo-check
        !           171: Whether to check file transfers by examining what the remote system
        !           172: echoes back.  This probably doesn't work very well.  The default is
        !           173: false.
        !           174: .TP 5
        !           175: .B echonl
        !           176: The character to look for after sending each line in a file.  The
        !           177: default is carriage return.
        !           178: .TP 5
        !           179: .B timeout
        !           180: The timeout to use, in seconds, when looking for a character, either
        !           181: when doing echo checking or when looking for the
        !           182: .B echonl
        !           183: character.  The default is 30.
        !           184: .TP 5
        !           185: .B kill
        !           186: The character to use delete a line if the echo check fails.  The
        !           187: default is ^U.
        !           188: .TP 5
        !           189: .B resend
        !           190: The number of times to resend a line if the echo check continues to
        !           191: fail.  The default is 10.
        !           192: .TP 5
        !           193: .B eofwrite
        !           194: The string to write after sending a file with the
        !           195: .B ~>
        !           196: command.  The default is ^D.
        !           197: .TP 5
        !           198: .B eofread
        !           199: The string to look for when receiving a file with the
        !           200: .B ~<
        !           201: command.  The default is $, which is intended to be a typical shell
        !           202: prompt.
        !           203: .TP 5
        !           204: .B verbose
        !           205: Whether to print accumulated information during a file transfer.  The
        !           206: default is true.
        !           207: .SH OPTIONS
        !           208: The following options may be given to
        !           209: .I cu.
        !           210: .TP 5
        !           211: .B \-e
        !           212: Use even parity.
        !           213: .TP 5
        !           214: .B \-o
        !           215: Use odd parity.  If both
        !           216: .B \-e
        !           217: and
        !           218: .B \-o
        !           219: are used, no parity is used.  Otherwise the default parity of the line
        !           220: is used.
        !           221: .TP 5
        !           222: .B \-h
        !           223: Echo characters locally (half-duplex mode).
        !           224: .TP 5
        !           225: .B \-z system
        !           226: The system to call.
        !           227: .TP 5
        !           228: .B \-c phone-number
        !           229: The phone number to call.
        !           230: .TP 5
        !           231: .B \-p port
        !           232: Name the port to use.
        !           233: .TP 5
        !           234: .B \-a port
        !           235: Equivalent to
        !           236: .B \-p port.
        !           237: .TP 5
        !           238: .B \-l line
        !           239: Name the line to use by giving a device name.  This may be used to
        !           240: dial out on ports that are not listed in the UUCP configuration files.
        !           241: Write access to the device is required.
        !           242: .TP 5
        !           243: .B \-s speed
        !           244: The speed (baud rate) to use.
        !           245: .TP 5
        !           246: .B \-#
        !           247: Where # is a number, equivalent to
        !           248: .B \-s #.
        !           249: .TP 5
        !           250: .B \-n
        !           251: Prompt for the phone number to use.
        !           252: .TP 5
        !           253: .B \-d
        !           254: Enter debugging mode.  Equivalent to
        !           255: .B \-x all.
        !           256: .TP 5
        !           257: .B \-x type
        !           258: Turn on particular debugging types.  The following types are
        !           259: recognized: abnormal, chat, handshake, uucp-proto, proto, port,
        !           260: config, spooldir, execute, incoming, outgoing.  Only abnormal, chat,
        !           261: handshake, port, config, incoming and outgoing are meaningful for
        !           262: .I cu.
        !           263: 
        !           264: Multiple types may be given, separated by commas, and the
        !           265: .B \-x
        !           266: option may appear multiple times.  A number may also be given, which
        !           267: will turn on that many types from the foregoing list; for example,
        !           268: .B \-x 2
        !           269: is equivalent to
        !           270: .B \-x abnormal,chat.
        !           271: .B \-x all
        !           272: may be used to turn on all debugging options.
        !           273: .TP 5
        !           274: .B \-I file
        !           275: Set configuration file to use.  This option may not be available,
        !           276: depending upon how
        !           277: .I cu
        !           278: was compiled.
        !           279: .SH BUGS
        !           280: This program does not work very well.
        !           281: .SH FILES
        !           282: The file name may be changed at compilation time, so this is only an
        !           283: approximation.
        !           284: 
        !           285: .br
        !           286: /usr/lib/uucp/config - Configuration file.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.