|
|
1.1 root 1: ''' $Id: uucp.1,v 1.1 93/07/30 07:58:23 bin Exp Locker: bin $
2: .TH uucp 1 "Taylor UUCP 1.04"
3: .SH NAME
4: uucp \- Unix to Unix copy
5: .SH SYNOPSIS
6: .B uucp
7: [ options ] source-file destination-file
8: .PP
9: .B uucp
10: [ options ] source-file... destination-directory
11: .SH DESCRIPTION
12: The
13: .I uucp
14: command copies files between systems. Each
15: .I file
16: argument is either a pathname on the local machine or is of the form
17: .IP
18: system!path
19: .LP
20: which is interpreted as being on a remote system.
21: In the first form, the contents of the first file are copied to the
22: second. In the second form, each source file is copied into the
23: destination directory.
24:
25: A file be transferred to or from
26: .I system2
27: via
28: .I system1
29: by using
30: .IP
31: system1!system2!path.
32: .LP
33:
34: Any pathname that does not begin with / or ~ will be appended to the
35: current directory (unless the
36: .B \-W
37: option is used); this resulting path will not necessarily exist on a
38: remote system. A pathname beginning with a simple ~ starts at the
39: UUCP public directory; a pathname beginning with ~name starts at the
40: home directory of the named user. The ~ is interpreted on the
41: appropriate system. Note that some shells will interpret a simple ~
42: to the local home directory before
43: .I uucp
44: sees it; to avoid this the ~ must be quoted.
45:
46: Shell metacharacters ? * [ ] are interpreted on the appropriate
47: system, assuming they are quoted to prevent the shell from
48: interpreting them first.
49:
50: The copy does not take place immediately, but is queued up for the
51: .I uucico
52: (8) daemon; the daemon is started immediately unless the
53: .B \-r
54: switch is given. In any case, the next time the remote system is called the
55: file(s) will be copied.
56: .SH OPTIONS
57: The following options may be given to
58: .I uucp.
59: .TP 5
60: .B \-c
61: Do not copy local source files to the spool directory. If they are
62: removed before being processed by the
63: .I uucico
64: (8) daemon, the copy will fail. The files must be readable by the
65: .I uucico
66: (8) daemon, and by the invoking user.
67: .TP 5
68: .B \-C
69: Copy local source files to the spool directory. This is the default.
70: .TP 5
71: .B \-d
72: Create all necessary directories when doing the copy. This is the
73: default.
74: .TP 5
75: .B \-f
76: If any necessary directories do not exist for the destination path,
77: abort the copy.
78: .TP 5
79: .B \-g grade
80: Set the grade of the file transfer command. Jobs of a higher grade
81: are executed first. Grades run 0 ... 9 A ... Z a ... z from high to
82: low.
83: .TP 5
84: .B \-m
85: Report completion or failure of the file transfer by
86: .I mail
87: (1).
88: .TP 5
89: .B \-n user
90: Report completion or failure of the file transfer by
91: .I mail
92: (1) to the named
93: user on the remote system.
94: .TP 5
95: .B \-r
96: Do not start
97: .I uucico
98: (8) daemon immediately; merely queue up the file transfer for later
99: execution.
100: .TP 5
101: .B \-j
102: Print jobid on standard output. The job may be
103: later cancelled by passing the jobid to the
104: .B \-k
105: switch of
106: .I uustat
107: (1).
108: It is possible for some complex operations to produce more than one
109: jobid, in which case each will be printed on a separate line. For
110: example
111: .EX
112: uucp sys1!~user1/file1 sys2!~user2/file2 /usr/spool/uucppublic
113: .EE
114: will generate two separate jobs, one for the system
115: .I sys1
116: and one for the system
117: .I sys2.
118: .TP 5
119: .B \-W
120: Do not prepend remote relative path names with the current directory.
121: .TP 5
122: .B \-x type
123: Turn on particular debugging types. The following types are
124: recognized: abnormal, chat, handshake, uucp-proto, proto, port,
125: config, spooldir, execute, incoming, outgoing. Only abnormal, config,
126: spooldir and execute are meaningful for
127: .I uucp.
128:
129: Multiple types may be given, separated by commas, and the
130: .B \-x
131: option may appear multiple times. A number may also be given, which
132: will turn on that many types from the foregoing list; for example,
133: .B \-x 2
134: is equivalent to
135: .B \-x abnormal,chat.
136: .TP 5
137: .B \-I file
138: Set configuration file to use. This option may not be available,
139: depending upon how
140: .I uucp
141: was compiled.
142: .SH FILES
143: The file names may be changed at compilation time or by the
144: configuration file, so these are only approximations.
145:
146: .br
147: /usr/lib/uucp/config - Configuration file.
148: .br
149: /usr/spool/uucp -
150: UUCP spool directory.
151: .br
152: /usr/spool/uucp/Log -
153: UUCP log file.
154: .br
155: /usr/spool/uucppublic -
156: Default UUCP public directory.
157: .SH SEE ALSO
158: mail(1), uux(1), uustat(1), uucico(8)
159: .SH BUGS
160: Some of the options are dependent on the capabilities of the
161: .I uucico
162: (8) daemon on the remote system.
163:
164: The
165: .I \-n
166: and
167: .I \-m
168: switches do not work when transferring a file from one remote system
169: to another.
170:
171: File modes are not preserved, except for the execute bit. The
172: resulting file is owned by the uucp user.
173: .SH AUTHOR
174: Ian Lance Taylor
175: ([email protected] or uunet!airs!ian)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.