Return to bscbatch.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc

Annotation of cci/usr/src/usr.bin/bsc/doc/bscbatch.1, revision 1.1

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.