Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 304 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/cu.1 b/upstream/mageia-cauldron/man1/cu.1
new file mode 100644
index 00000000..67e0f066
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/cu.1
@@ -0,0 +1,304 @@
+''' $Id: cu.1,v 1.10 2002/03/05 22:13:33 ian Rel $
+.TH cu 1 "Taylor UUCP 1.07"
+.SH NAME
+cu \- Call up another system
+.SH SYNOPSIS
+.B cu
+[ options ] [ system | phone | "dir" ]
+.SH DESCRIPTION
+The
+.I cu
+command is used to call up another system and act as a dial in
+terminal.  It can also do simple file transfers with no error
+checking.
+
+.I cu
+takes a single argument, besides the options.  If the argument is the
+string "dir" cu will make a direct connection to the port.  This may
+only be used by users with write access to the port, as it permits
+reprogramming the modem.
+
+Otherwise, if the argument begins with a digit, it is taken to be a
+phone number to call.  Otherwise, it is taken to be the name of a
+system to call.  The
+.B \-z
+or
+.B \-\-system
+option may be used to name a system beginning with a digit, and the
+.B \-c
+or
+.B \-\-phone
+option may be used to name a phone number that does not begin with a
+digit.
+
+.I cu
+locates a port to use in the UUCP configuration files.  If a simple
+system name is given, it will select a port appropriate for that
+system.  The
+.B \-p, \-\-port, \-l, \-\-line, \-s
+and
+.B \-\-speed
+options may be used to control the port selection.
+
+When a connection is made to the remote system,
+.I cu
+forks into two processes.  One reads from the port and writes to the
+terminal, while the other reads from the terminal and writes to the
+port.
+
+.I cu
+provides several commands that may be used during the conversation.
+The commands all begin with an escape character, initially
+.B ~
+(tilde).  The escape character is only recognized at the beginning of
+a line.  To send an escape character to the remote system at the start
+of a line, it must be entered twice.  All commands are either a single
+character or a word beginning with
+.B %
+(percent sign).
+
+.I cu
+recognizes the following commands:
+
+.TP 5
+.B ~.
+Terminate the conversation.
+.TP 5
+.B ~! command
+Run command in a shell.  If command is empty, starts up a shell.
+.TP 5
+.B ~$ command
+Run command, sending the standard output to the remote system.
+.TP 5
+.B ~| command
+Run command, taking the standard input from the remote system.
+.TP 5
+.B ~+ command
+Run command, taking the standard input from the remote system and
+sending the standard output to the remote system.
+.TP 5
+.B ~#, ~%break
+Send a break signal, if possible.
+.TP 5
+.B ~c directory, ~%cd directory
+Change the local directory.
+.TP 5
+.B ~> file
+Send a file to the remote system.  This just dumps the file over the
+communication line.  It is assumed that the remote system is expecting
+it.
+.TP 5
+.B ~<
+Receive a file from the remote system.  This prompts for the local
+file name and for the remote command to execute to begin the file
+transfer.  It continues accepting data until the contents of the
+.B eofread
+variable are seen.
+.TP 5
+.B ~p from to, ~%put from to
+Send a file to a remote Unix system.  This runs the appropriate
+commands on the remote system.
+.TP 5
+.B ~t from to, ~%take from to
+Retrieve a file from a remote Unix system.  This runs the appropriate
+commands on the remote system.
+.TP 5
+.B ~s variable value
+Set a
+.I cu
+variable to the given value.  If value is not given, the variable is
+set to
+.B true.
+.TP 5
+.B ~! variable
+Set a
+.I cu
+variable to
+.B false.
+.TP 5
+.B ~z
+Suspend the cu session.  This is only supported on some systems.  On
+systems for which ^Z may be used to suspend a job, 
+.B ~^Z
+will also suspend the session.
+.TP 5
+.B ~%nostop
+Turn off XON/XOFF handling.
+.TP 5
+.B ~%stop
+Turn on XON/XOFF handling.
+.TP 5
+.B ~v
+List all the variables and their values.
+.TP 5
+.B ~?
+List all commands.
+
+.I cu
+also supports several variables.  They may be listed with the
+.B ~v
+command, and set with the
+.B ~s
+or
+.B ~!
+commands.
+
+.TP 5
+.B escape
+The escape character.  Initially
+.B ~
+(tilde).
+.TP 5
+.B delay
+If this variable is true,
+.I cu
+will delay for a second after recognizing the escape character before
+printing the name of the local system.  The default is true.
+.TP 5
+.B eol
+The list of characters which are considered to finish a line.  The
+escape character is only recognized after one of these is seen.  The
+default is carriage return, ^U, ^C, ^O, ^D, ^S, ^Q, ^R.
+.TP 5
+.B binary
+Whether to transfer binary data when sending a file.  If this is
+false, then newlines in the file being sent are converted to carriage
+returns.  The default is false.
+.TP 5
+.B binary-prefix
+A string used before sending a binary character in a file transfer, if
+the
+.B binary
+variable is true.  The default is ^V.
+.TP 5
+.B echo-check
+Whether to check file transfers by examining what the remote system
+echoes back.  This probably doesn't work very well.  The default is
+false.
+.TP 5
+.B echonl
+The character to look for after sending each line in a file.  The
+default is carriage return.
+.TP 5
+.B timeout
+The timeout to use, in seconds, when looking for a character, either
+when doing echo checking or when looking for the
+.B echonl
+character.  The default is 30.
+.TP 5
+.B kill
+The character to use delete a line if the echo check fails.  The
+default is ^U.
+.TP 5
+.B resend
+The number of times to resend a line if the echo check continues to
+fail.  The default is 10.
+.TP 5
+.B eofwrite
+The string to write after sending a file with the
+.B ~>
+command.  The default is ^D.
+.TP 5
+.B eofread
+The string to look for when receiving a file with the
+.B ~<
+command.  The default is $, which is intended to be a typical shell
+prompt.
+.TP 5
+.B verbose
+Whether to print accumulated information during a file transfer.  The
+default is true.
+.SH OPTIONS
+The following options may be given to
+.I cu.
+.TP 5
+.B \-e, \-\-parity=even
+Use even parity.
+.TP 5
+.B \-o, \-\-parity=odd
+Use odd parity.
+.TP 5
+.B \-\-parity=none
+Use no parity.  No parity is also used if both
+.B \-e
+and
+.B \-o
+are given.
+.TP 5
+.B \-h, \-\-halfduplex
+Echo characters locally (half-duplex mode).
+.TP 5
+.B \-\-nostop
+Turn off XON/XOFF handling (it is on by default).
+.TP 5
+.B \-E char, \-\-escape char
+Set the escape character.  Initially
+.B ~
+(tilde).  To eliminate the escape character, use
+.B -E ''.
+.TP 5
+.B \-z system, \-\-system system
+The system to call.
+.TP 5
+.B \-c phone-number, \-\-phone phone-number
+The phone number to call.
+.TP 5
+.B \-p port, \-\-port port
+Name the port to use.
+.TP 5
+.B \-a port
+Equivalent to
+.B \-\-port port.
+.TP 5
+.B \-l line, \-\-line line
+Name the line to use by giving a device name.  This may be used to
+dial out on ports that are not listed in the UUCP configuration files.
+Write access to the device is required.
+.TP 5
+.B \-s speed, \-\-speed speed
+The speed (baud rate) to use.
+.TP 5
+.B \-#
+Where # is a number, equivalent to
+.B \-\-speed #.
+.TP 5
+.B \-n, \-\-prompt
+Prompt for the phone number to use.
+.TP 5
+.B \-d
+Enter debugging mode.  Equivalent to
+.B \-\-debug all.
+.TP 5
+.B \-x type, \-\-debug type
+Turn on particular debugging types.  The following types are
+recognized: abnormal, chat, handshake, uucp-proto, proto, port,
+config, spooldir, execute, incoming, outgoing.  Only abnormal, chat,
+handshake, port, config, incoming and outgoing are meaningful for
+.I cu.
+
+Multiple types may be given, separated by commas, and the
+.B \-\-debug
+option may appear multiple times.  A number may also be given, which
+will turn on that many types from the foregoing list; for example,
+.B \-\-debug 2
+is equivalent to
+.B \-\-debug abnormal,chat.
+.B \-\-debug all
+may be used to turn on all debugging options.
+.TP 5
+.B \-I file, \-\-config file
+Set configuration file to use.  This option may not be available,
+depending upon how
+.I cu
+was compiled.
+.TP 5
+.B \-v, \-\-version
+Report version information and exit.
+.TP 5
+.B \-\-help
+Print a help message and exit.
+.SH BUGS
+This program does not work very well.
+.SH AUTHOR
+Ian Lance Taylor
+<ian@airs.com>