cu(1)
NAME
cu - Call up another system
SYNOPSIS
cu [ options ] [ system | phone | "dir" ]
DESCRIPTION
The 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.
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 -z or --system option may be used to name a system
beginning with a digit, and the -c or --phone option may be used to
name a phone number that does not begin with a digit.
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 -p, --port, -l, --line, -s and --speed options may be used
to control the port selection.
When a connection is made to the remote system, 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.
cu provides several commands that may be used during the conversation.
The commands all begin with an escape character, initially ~ (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 % (percent sign).
cu recognizes the following commands:
~. Terminate the conversation.
~! command
Run command in a shell. If command is empty, starts up a shell.
~$ command
Run command, sending the standard output to the remote system.
~| command
Run command, taking the standard input from the remote system.
~+ command
Run command, taking the standard input from the remote system and
sending the standard output to the remote system.
~#, ~%break
Send a break signal, if possible.
~c directory, ~%cd directory
Change the local directory.
~> 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.
~< 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
eofread variable are seen.
~p from to, ~%put from to
Send a file to a remote Unix system. This runs the appropriate
commands on the remote system.
~t from to, ~%take from to
Retrieve a file from a remote Unix system. This runs the
appropriate commands on the remote system.
~s variable value
Set a cu variable to the given value. If value is not given, the
variable is set to true.
~! variable
Set a cu variable to false.
~z Suspend the cu session. This is only supported on some systems.
On systems for which ^Z may be used to suspend a job, ~^Z will
also suspend the session.
~%nostop
Turn off XON/XOFF handling.
~%stop
Turn on XON/XOFF handling.
~v List all the variables and their values.
~? List all commands.
cu also supports several variables. They may be listed with the
~v command, and set with the ~s or ~! commands.
escape
The escape character. Initially ~ (tilde).
delay
If this variable is true, cu will delay for a second after
recognizing the escape character before printing the name of the
local system. The default is true.
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.
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.
binary-prefix
A string used before sending a binary character in a file
transfer, if the binary variable is true. The default is ^V.
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.
echonl
The character to look for after sending each line in a file. The
default is carriage return.
timeout
The timeout to use, in seconds, when looking for a character,
either when doing echo checking or when looking for the echonl
character. The default is 30.
kill The character to use delete a line if the echo check fails. The
default is ^U.
resend
The number of times to resend a line if the echo check continues
to fail. The default is 10.
eofwrite
The string to write after sending a file with the ~> command. The
default is ^D.
eofread
The string to look for when receiving a file with the ~< command.
The default is $, which is intended to be a typical shell prompt.
verbose
Whether to print accumulated information during a file transfer.
The default is true.
OPTIONS
The following options may be given to cu.
-e, --parity=even
Use even parity.
-o, --parity=odd
Use odd parity.
--parity=none
Use no parity. No parity is also used if both -e and -o are
given.
-h, --halfduplex
Echo characters locally (half-duplex mode).
--nostop
Turn off XON/XOFF handling (it is on by default).
-E char, --escape char
Set the escape character. Initially ~ (tilde). To eliminate the
escape character, use -E ''.
-z system, --system system
The system to call.
-c phone-number, --phone phone-number
The phone number to call.
-p port, --port port
Name the port to use.
-a port
Equivalent to --port port.
-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.
-s speed, --speed speed
The speed (baud rate) to use.
-# Where # is a number, equivalent to --speed #.
-n, --prompt
Prompt for the phone number to use.
-d Enter debugging mode. Equivalent to --debug all.
-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 cu.
Multiple types may be given, separated by commas, and the --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, --debug 2 is equivalent to --debug abnormal,chat.
--debug all may be used to turn on all debugging options.
-I file, --config file
Set configuration file to use. This option may not be available,
depending upon how cu was compiled.
-v, --version
Report version information and exit.
--help
Print a help message and exit.
BUGS
This program does not work very well.
AUTHOR
Ian Lance Taylor <ian@airs.com>
Taylor UUCP 1.07 cu(1)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
