![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to cu.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104|
Return to cu.1 CVS log | Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104 |
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.