![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to bscbatch.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc|
Return to bscbatch.1 CVS log | Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc |
1.1 root 1: .TH BSCBATCH 1C 1.4 DLBA
2: .SH NAME
3: bscbatch \- BISYNC Batch Job Submission and Query
4: .SH SYNOPSIS
5: .I
6: bscbatch [-to=hostname] [-copy] [-mail] [-transp] [file ...]
7: .br
8: .I
9: bscbatch -q[=hostname] [-t=time] [-l=lines]
10: .br
11: .SH DESCRIPTION
12: .P
13: The
14: .I bscbatch
15: utility is used to submit files to the BISYNC daemon
16: .I (bscd)
17: for transmission to a
18: host, and to search among files received from a specific host for
19: a particular file.
20: .SS "Sending Files."
21: .P
22: The first form of invocation queues files or the standard input for
23: sending to a specific host
24: .I (hostname),
25: or to the
26: .I default
27: host. Ordinarily, if file names are specified instead of standard input,
28: .I bscbatch
29: will queue the files by name; the
30: .I -copy
31: parameter forces
32: .I bscbatch
33: to make a copy of the file as is. The
34: .I -mail
35: flag instructs the BISYNC daemon to
36: send mail to the invoker upon successful completion of transmission;
37: normally, mail is only sent if there is a problem in the transmission.
38: The
39: .I -transp
40: flag forces transmission of the file
41: in transparent mode; usually, the daemon checks the file as it is
42: being transmitted to see if it contains any control characters which
43: would force it to be sent in transparent mode.
44: .P
45: Specifying multiple files to
46: .I bscbatch
47: has the same effect as specifying one file per
48: .I bscbatch
49: invocation -- the files will be sent
50: as individual files. In order to send several files together as one
51: file, one may use:
52: .br
53: cat file1 file2 ... | bscbatch
54: .br
55: .SS "Receiving Files."
56: .P
57: The second form of invocation is used to search files received from
58: a specific host for one belonging to the invoker. Unless an installation
59: exit has been supplied (see
60: .I batch(8))
61: which can
62: tell one user's output from another, received files will be left
63: for a period of time (determined by the system administrator) in
64: the BISYNC daemon's spool area for that host; if this is the case,
65: users should use this form of invocation to locate their files and
66: either link to or copy those files.
67: .P
68: The
69: .I -q
70: parameter indicates this is a search operation.
71: The host name is optional; as in sending files, there is a default
72: host.
73: The
74: .I -t=hh[mm]
75: parameter is used to limit the search to those files received within the last
76: .I hh
77: hours (and, optionally,
78: .I mm
79: minutes). The default is to display all files received from that host.
80: .P
81: When invoked in the search mode, the name and
82: first few lines of each file
83: received (according to any time limits set via -t) are displayed.
84: The default is to display 20 lines; this may be overridden via the
85: .I -l=lines
86: parameter.
87: .I Bscbatch
88: stops after each display and displays the message:
89: .IP
90: ">>>> Rename? (Y/N): "
91: .LP
92: This gives the invoker a chance to examine the file.
93: The invoker may enter Y, to rename the file, or N, to go on to the
94: next file.
95: .I Bscbatch
96: displays the message:
97: .IP
98: ">>>> Press Return to Continue <<<<"
99: .P
100: and waits for a newline from standard input before continuing if the invoker
101: enters N.
102: .P
103: If the file is to be renamed,
104: .I bscbatch
105: displays the message:
106: .IP
107: ">>>> Enter New File Name: "
108: .LP
109: The new file name may then be entered.
110: .I Bscbatch
111: checks whether or not the file already exists, asking whether it should be
112: overwritten if it does. If the file doesn't exist or it's okay to overwrite
113: it, the message:
114: .IP
115: ">>>> Verify move <old file name> to <new file name> (y/n):"
116: .LP
117: is displayed. If y is entered, the file is renamed.
118: .I Bscbatch
119: then displays the message
120: .IP
121: ">>>> Press Return to Continue <<<<"
122: .LP
123: and waits
124: for a newline entry from standard input.
125: When the invoker has processed the proper file(s),
126: .I bscbatch
127: may be interrupted.
128: .SH FILES
129: .TP
130: /usr/lib/bscbatch/<host>
131: Host configuration parameters
132: .TP
133: /usr/spool/bscbatch/<host>/C*
134: Transmission control file
135: .TP
136: /usr/spool/bscbatch/<host>/D*
137: Data file to be sent, if -copy specified or standard input used
138: .TP
139: /usr/spool/bscbatch/<host>/P*
140: Files received from host
141: .TP
142: /usr/spool/bscbatch/<host>/AUDIT
143: Optional audit trail entry made when file(s) submitted
144: .SH "SEE ALSO"
145: .IP bscpr(1c)
146: batch file print utility
147: .IP bsclog(8)
148: batch audit trail utility
149: .IP batch(8)
150: BISYNC batch facility
151: .SH DIAGNOSTICS
152: .P
153: bscbatch: host <hostname> unknown.
154: .IP
155: The host name mentioned in the
156: .I -to=
157: or the
158: .I -q=
159: parameter was not found in /usr/lib/bscbatch.
160: Contact the system administrator for a list of valid host names.
161: .P
162: bscbatch: can't create <filename>.
163: .IP
164: An attempt to create the mentioned file in the host's spool area
165: was unsuccessful. Contact the system administrator; directory modes
166: or permissions are awry.
167: .P
168: bscbatch: don't know who you are!
169: .IP
170: The password file was searched for your user number so that your
171: name would be known for any necessary mail. Either you aren't in
172: the password file, or
173: .I bscbatch
174: can't read it.
175: .P
176: bscbatch: file <filename> not found.
177: .IP
178: The named file was given as a parameter, but does not seem to exist.
179: General read permission should probably be available on the file
180: so that the BISYNC daemon can read it.
181: .P
182: bscbatch: host <hostname> can't receive transparent files.
183: .IP
184: The
185: .I -transp
186: flag was specified, however, according to the host's configuration file,
187: the named host can't receive transparent files.
188: .P
189: bscbatch: file system nearly full. Response file from host may be
190: delayed.
191: .IP
192: The system administrator has specified a minimum amount of space
193: which should be available on the file system before any receive activity
194: takes place. The file system is nearly down to that minimum level,
195: so the daemon could be forced to refuse from the host if the situation
196: gets worse. This is a warning only.
197: .P
198: bscbatch: can't copy your files -- file system too full.
199: .IP
200: See the preceeding message. There is less than the minimum amount
201: of free space left in the file system, so your files can't be copied
202: to the host's spool area. You may, however, be able to queue your
203: file(s) by giving an explicit file name and no copy option.
204: .P
205: bscbatch: not a number (<flag>)
206: .IP
207: The
208: .I -t
209: or
210: .I -l
211: parameters require
212: numeric values. What was given (shown in parentheses) was not numeric.
213: .P
214: bscbatch: unrecognized option (<flag>)
215: .IP
216: The parameter shown in parentheses was not one from those shown in the
217: SYNOPSIS.
218: .P
219: bscbatch: options -copy, -mail, and -transp can't be used with -q
220: .P
221: bscbatch: options -l and -t can't be used with -to
222: .IP
223: The
224: .I -t
225: and
226: .I -l
227: parameters cannot be used except with
228: .I -q
229: specified.
230: The
231: .I
232: -copy, -mail, -to, -transp,
233: and
234: .I file
235: parameters may not be used with
236: .I -q
237: specified.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.