[unix-history] / usr / man / man1 / cu.1c

.TH CU 1C 
.SH NAME
cu \- call UNIX
.SH SYNOPSIS
.B cu
telno
[
.BR \-t ""
]
[
.BR \-s ""
speed ]
[
.BR \-a ""
acu ]
[
.BR \-l ""
line ]
.SH DESCRIPTION
.I Cu
calls up another UNIX system,
a terminal,
or possibly a non-UNIX system.
It manages an interactive conversation with possible
transfers of text files.
.I Telno
is the telephone number,
with minus signs at appropriate places for delays.
The
.BR \-t ""
flag is used to dial out to a terminal.
.I Speed
gives the transmission speed (110, 134, 150, 300, 1200);
300 is the default value.
.PP
The
.BR \-a ""
and
.BR \-l ""
values may be used to
specify pathnames
for the ACU and communications line devices.
They can be used to override the following
built-in choices:
.PP
.BR \-a " /dev/cua0"
.BR \-l " /dev/cul0"
.PP
After making the connection,
.I cu
runs as two processes:
the
.I send
process reads the standard input and
passes most of it to the remote system;
the
.I receive
process reads from the remote system and passes
most data to the standard output.
Lines beginning with `~' have special meanings.
.PP
The
.I send
process interprets the following:
.TP 18
~\|\fB.\|
terminate the conversation.
.br
.ns
.TP 18
~EOT
terminate the conversation
.TP 18
~<file
send the contents of
.I file
to the remote system,
as though typed at the terminal.
.TP 18
~!
invoke an interactive shell on the local system.
.TP 18
~!cmd ...
run the command on the local system
(via
.BR "sh \-c" ")."
.TP 18
~$cmd ...
run the command locally and send its output
to the remote system.
.TP 18
~%take from [to]
copy file `from' (on the remote system)
to file `to' on the local system.
If `to' is omitted,
the `from' name is used both places.
.TP 18
~%put from [to]
copy file `from' (on local system)
to file `to' on remote system.
If `to' is omitted, the `from' name is used both places.
.TP 18
~~\fB\|.\|.\|.\fR
send
the line `~\|.\|.\|.'.
.PP
The
.I receive
process handles output diversions of the following form:
.PP
\&~>[>][:]file
.br
zero or more lines to be written to file
.br
\&~>
.PP
In any case, output is diverted (or appended, if `>>' used) to the file.
If `:' is used,
the diversion is
.I silent,
i.e., it is written only to the file.
If `:' is omitted,
output is written both to the file and to the standard output.
The trailing `~>' terminates the diversion.
.PP
The use of
.B  ~%put
requires
.I stty
and
.I cat
on the remote side.
It also requires that the
current erase and kill characters on the remote
system be identical to the current ones on the local system.
Backslashes are inserted at appropriate places.
.PP
The use of
.B  ~%take
requires the existence of
.I echo
and
.I tee
on the remote system.
Also,
.B "stty tabs"
mode is required on the remote system if
tabs are to be copied without expansion.
.SH FILES
/dev/cua0
.br
/dev/cul0
.br
/dev/null
.SH "SEE ALSO"
dn(4), tty(4)
.SH DIAGNOSTICS
Exit code is
zero for normal exit,
nonzero (various values) otherwise.
.SH BUGS
The syntax is unique.
Commit	Line	Data
84fa098f LM	1	.TH CU 1C
	2	.SH NAME
	3	cu \- call UNIX
	4	.SH SYNOPSIS
	5	.B cu
	6	telno
	7	[
	8	.BR \-t ""
	9	]
	10	[
	11	.BR \-s ""
	12	speed ]
	13	[
	14	.BR \-a ""
	15	acu ]
	16	[
	17	.BR \-l ""
	18	line ]
	19	.SH DESCRIPTION
	20	.I Cu
	21	calls up another UNIX system,
	22	a terminal,
	23	or possibly a non-UNIX system.
	24	It manages an interactive conversation with possible
	25	transfers of text files.
	26	.I Telno
	27	is the telephone number,
	28	with minus signs at appropriate places for delays.
	29	The
	30	.BR \-t ""
	31	flag is used to dial out to a terminal.
	32	.I Speed
	33	gives the transmission speed (110, 134, 150, 300, 1200);
	34	300 is the default value.
	35	.PP
	36	The
	37	.BR \-a ""
	38	and
	39	.BR \-l ""
	40	values may be used to
	41	specify pathnames
	42	for the ACU and communications line devices.
	43	They can be used to override the following
	44	built-in choices:
	45	.PP
	46	.BR \-a " /dev/cua0"
	47	.BR \-l " /dev/cul0"
	48	.PP
	49	After making the connection,
	50	.I cu
	51	runs as two processes:
	52	the
	53	.I send
	54	process reads the standard input and
	55	passes most of it to the remote system;
	56	the
	57	.I receive
	58	process reads from the remote system and passes
	59	most data to the standard output.
	60	Lines beginning with `~' have special meanings.
	61	.PP
	62	The
	63	.I send
	64	process interprets the following:
65	.TP 18
66	~\\|\fB.\\|
67	terminate the conversation.
68	.br
69	.ns
70	.TP 18
71	~EOT
72	terminate the conversation
73	.TP 18
74	~<file
75	send the contents of
76	.I file
77	to the remote system,
78	as though typed at the terminal.
79	.TP 18
80	~!
81	invoke an interactive shell on the local system.
82	.TP 18
83	~!cmd ...
84	run the command on the local system
85	(via
86	.BR "sh \-c" ")."
87	.TP 18
88	~$cmd ...
89	run the command locally and send its output
90	to the remote system.
91	.TP 18
92	~%take from [to]
93	copy file `from' (on the remote system)
94	to file `to' on the local system.
95	If `to' is omitted,
96	the `from' name is used both places.
97	.TP 18
98	~%put from [to]
99	copy file `from' (on local system)
100	to file `to' on remote system.
101	If `to' is omitted, the `from' name is used both places.
102	.TP 18
103	~~\fB\\|.\\|.\\|.\fR
104	send
105	the line `~\\|.\\|.\\|.'.
106	.PP
107	The
108	.I receive
109	process handles output diversions of the following form:
110	.PP
111	\&~>[>][:]file
112	.br
113	zero or more lines to be written to file
114	.br
115	\&~>
116	.PP
117	In any case, output is diverted (or appended, if `>>' used) to the file.
118	If `:' is used,
119	the diversion is
120	.I silent,
121	i.e., it is written only to the file.
122	If `:' is omitted,
123	output is written both to the file and to the standard output.
124	The trailing `~>' terminates the diversion.
125	.PP
126	The use of
127	.B ~%put
128	requires
129	.I stty
130	and
131	.I cat
132	on the remote side.
133	It also requires that the
134	current erase and kill characters on the remote
135	system be identical to the current ones on the local system.
136	Backslashes are inserted at appropriate places.
137	.PP
138	The use of
139	.B ~%take
140	requires the existence of
141	.I echo
142	and
143	.I tee
144	on the remote system.
145	Also,
146	.B "stty tabs"
147	mode is required on the remote system if
148	tabs are to be copied without expansion.
149	.SH FILES
150	/dev/cua0
151	.br
152	/dev/cul0
153	.br
154	/dev/null
155	.SH "SEE ALSO"
156	dn(4), tty(4)
157	.SH DIAGNOSTICS
158	Exit code is
159	zero for normal exit,
160	nonzero (various values) otherwise.
161	.SH BUGS
162	The syntax is unique.