home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / ncsatlnt / tel23doc.zip / CHAP.4 < prev    next >
Text File  |  1991-07-01  |  33KB  |  1,105 lines
  1.     
  2.  
  3.  
  4.     
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                                                 
  13.  
  14.  
  15.  
  16.  
  17.  
  18. 4.1    NCSA Telnet
  19.  
  20. Utility Programs    4.1
  21.  
  22. National Center for Supercomputing Applications
  23.  
  24. June 1991
  25.  
  26.                                                               
  27.  
  28.  
  29. June 1991
  30.  
  31.  
  32.  
  33.  
  34. Chapter 4    Utility Programs
  35.  
  36.  
  37.  
  38. Chapter Overview
  39. finger
  40. Name
  41. Command Line 
  42. Description
  43. Options
  44. ftp
  45. Name
  46. Command Line
  47. Description
  48. Options 
  49. Commands
  50. Aborting a File Transfer
  51. File Naming Conventions
  52. File Transfer Parameters
  53. lpq
  54. Name 
  55. Command Line
  56. Description
  57. Options
  58. Files
  59. See Also
  60. Diagnostics
  61. Bugs
  62. lpr
  63. Name 
  64. Command Line
  65. Description
  66. Options
  67. Diagnostics
  68. lprm
  69. Name 
  70. Command Line
  71. Description
  72. Options
  73. Diagnostics
  74. net14
  75. Name
  76. Command Line
  77. Description
  78. Usage
  79. Options
  80. rsh
  81. Name
  82. Command Line
  83. Description
  84. Options
  85. setclock
  86. Name 
  87. Command Line
  88. Description
  89. Options
  90.  
  91.  
  92. Overview
  93.  
  94. This appendix outlines in detail some helpful command 
  95. programs. Almost all the documentation for each of the commands 
  96. was taken from their online version written by Sun Microsystems 
  97. Inc. You can access this same online information by entering man 
  98. filename when you connect to a UNIX machine. For instance, to 
  99. access information about the finger command, you would enter:  
  100. man finger.
  101.  
  102.  
  103. finger
  104.  
  105. Name
  106. The finger command lists information about users.
  107.  
  108.  
  109. Command Line
  110. finger [ options ] name...
  111.  
  112.  
  113. Description
  114. By default, finger lists information about logged-in users, 
  115. including their: login name, full name, terminal name 
  116. (prepended with a `*' if write-permission is denied), idle time, 
  117. login time, and location (comment field in /etc/ttytab for users 
  118. logged in locally, hostname for users logged in remotely) if 
  119. known.
  120.  
  121. Idle time is minutes if it is a single integer, hours and minutes if a 
  122. ':' is present, or days and hours if a 'd' is present.
  123.  
  124. When one or more name arguments are given, more detailed 
  125. information is given for each name specified, whether they are 
  126. logged in or not. A name may be a first or last name, or an account 
  127. name. Information is presented in a multi-line format, and 
  128. includes, in addition to the information mentioned above:
  129.  
  130. the user's home directory and login shell; the time 
  131. they logged in; if they are currently logged in, or the 
  132. time they last logged in if they are not; the terminal 
  133. or host from which they logged in; and, if a terminal, 
  134. the comment field in /etc/ttytab for that terminal; the 
  135. last time they received mail; the last time they read 
  136. their mail; any plan contained in the file .plan in 
  137. the user's home directory; and any project on which 
  138. they are working, described in the file .project (also 
  139. in that directory)
  140.  
  141. If a name argument contains an at-sign, `@', then a connection is 
  142. attempted to the machine named after the at-sign, and the remote 
  143. finger daemon is queried. The data returned by that daemon is 
  144. printed. If a long format printout is to be produced, the /W option is 
  145. passed to the remote finger daemon.
  146.  
  147.  
  148. Options
  149. -m
  150. Matches arguments only on user name (not first or last name).
  151.  
  152.  
  153. -l
  154. Forces long output format.
  155.  
  156.  
  157. -s
  158. Forces short output format.
  159.  
  160.  
  161. -q
  162. Forces quick output format, which is similar to short format except 
  163. that only the login name, terminal, and login time are printed.
  164.  
  165.  
  166. -i
  167. Forces ``idle'' output format, which is similar to short format 
  168. except that only the login name, terminal, login time, and idle 
  169. time are printed.
  170.  
  171.  
  172. -b
  173. Suppresses printing the user's home directory and shell in a long 
  174. format printout.
  175.  
  176.  
  177. -f
  178. Suppresses printing the header that is normally printed in a non-
  179. long format printout.
  180.  
  181.  
  182. -w
  183. Suppresses printing the full name in a short format printout.
  184.  
  185.  
  186. -h
  187. Suppresses printing of the .project file in a long format printout.
  188.  
  189.  
  190. -p
  191. Suppresses printing of the .plan file in a long format printout.
  192.  
  193.  
  194. ftp
  195.  
  196. Name
  197. ftp - file transfer program
  198.  
  199.  
  200. Command Line
  201. ftp [ -dginvrsmhfe ] [ hostname ]
  202.  
  203.  
  204. Description
  205. ftp is the user interface to the ARPANET standard File Transfer 
  206. Protocol (FTP). ftp transfers files to and from a remote network 
  207. site.
  208.  
  209. The client host with which ftp is to communicate may be specified 
  210. on the command line. If this is done, ftp immediately attempts to 
  211. establish a connection to an FTP server on that host; otherwise, ftp 
  212. enters its command interpreter and awaits instructions from the 
  213. user. When ftp is awaiting commands from the user, it displays 
  214. the prompt `ftp>'.
  215.  
  216.  
  217. Options
  218. You may specify the options at the command line or to the 
  219. command interpreter.
  220.  
  221.  
  222. -d
  223. Enables debugging.
  224.  
  225.  
  226. -e <filename>
  227. Same as -f except prompts you for login name and password.
  228.  
  229.  
  230. -f <filename>
  231. Non-interactive FTP session. Executes commands in 
  232. <filename>.
  233.  
  234.  
  235. -g
  236. Disables filename globbing.
  237.  
  238.  
  239. -h <filename>
  240. Gives location of the config.tel file.
  241.  
  242.  
  243. -i
  244. Turns off interactive prompting during multiple file transfers.
  245.  
  246.  
  247. -m
  248. Uses built-in "more" command.
  249.  
  250. -n
  251. Does not attempt auto-login upon initial connection. If autologin is 
  252. enabled, ftp checks the .netrc file in the user's home directory for 
  253. an entry describing an account on the remote machine. If no entry 
  254. exists, ftp will prompt for the login name of the account on the 
  255. remote machine (the default is the login name on the local 
  256. machine), and, if necessary, prompts for a password and an 
  257. account with which to login.
  258.  
  259.  
  260. -r
  261. Disables output redirection.
  262.  
  263.  
  264. -s
  265. Disables slash flipping.
  266.  
  267.  
  268. -v
  269. Shows all responses from the remote server, as well as reports on 
  270. data transfer statistics. This is turned on by default if ftp is 
  271. running interactively with its input coming from the user's 
  272. terminal.
  273.  
  274.  
  275. Commands
  276. ! [ command ]
  277. Runs command as a shell command on the local machine. If no 
  278. command is given, invoke an interactive shell.
  279.  
  280.  
  281. account [ passwd ]
  282. Supplies a supplemental password required by a remote system for 
  283. access to resources once a login has been successfully completed. If 
  284. no argument is included, the user will be prompted for an account 
  285. password in a non-echoing input mode.
  286.  
  287.  
  288. ascii
  289. Sets the representation type to network ASCII. This is the default 
  290. type.
  291.  
  292.  
  293. bell
  294. Sounds a bell after each file transfer command is completed.
  295.  
  296.  
  297. binary
  298. Sets the representation type to image.
  299.  
  300.  
  301. bye
  302. Terminates the FTP session with the remote server and exits ftp. 
  303. An EOF will also terminate the session and exit.
  304.  
  305.  
  306. cd remote-directory
  307. Changes the working directory on the remote machine to remote-
  308. directory.
  309.  
  310.  
  311. close
  312. Terminates the FTP session with the remote server, and returns to 
  313. the command interpreter. Any defined macros are erased.
  314.  
  315.  
  316. delete remote-file
  317. Deletes the file remote-file on the remote machine.
  318.  
  319.  
  320. debug [ debug-value ]
  321. Toggles debugging mode. If an optional debug-value is specified it 
  322. is used to set the debugging level. When debugging is on, ftp prints 
  323. each command sent to the remote machine, preceded by the string `-
  324. ->'.
  325.  
  326.  
  327. dir [ remote-directory ] [ local-file ]
  328. Prints a listing of the directory contents in the directory, remote-
  329. directory, and, optionally, places the output in local-file. If no 
  330. directory is specified, the current working directory on the remote 
  331. machine is used. If no local file is specified, or local-file is
  332.  `-', output is sent to the terminal.
  333.  
  334.  
  335. get remote-file [ local-file ]
  336. Retrieves the remote-file and stores it on the local machine. If the 
  337. local file name is not specified, it is given the same name it has on 
  338. the remote machine, subject to alteration by the current case, 
  339. ntrans, and nmap settings. The current settings for representation 
  340. type, file structure, and transfer mode are used while transferring 
  341. the file.
  342.  
  343.  
  344. glob
  345. Toggles filename expansion, or globbing, for mdelete, mget and 
  346. mput. If globbing is turned off, filenames are taken literally.
  347.  
  348. Globbing for mput is done as in csh(1). For mdelete and mget, each 
  349. remote file name is expanded separately on the remote machine, 
  350. and the lists are not merged.
  351.  
  352. Expansion of a directory name is likely to be radically different 
  353. from expansion of the name of an ordinary file: the exact result 
  354. depends on the remote operating system and FTP server, and can 
  355. be previewed by doing `mls remote-files -'.
  356.  
  357. mget and mput are not meant to transfer entire directory subtrees 
  358. of files. You can do this by transferring a tar(1) archive of the 
  359. subtree (using a representation type of image as set by the binary 
  360. command).
  361.  
  362.  
  363. hash
  364. Toggles hash-sign (#) printing for each data block transferred. 
  365. The size of a data block is 1024 bytes.
  366.  
  367.  
  368. help [ command ]
  369. Prints an informative message about the meaning of the 
  370. command. If no argument is given, ftp prints a list of the known 
  371. commands.
  372.  
  373.  
  374. lcd [ directory ]
  375. Changes the working directory on the local machine. If no 
  376. directory is specified, the user's home directory is used.
  377.  
  378.  
  379. ls [ remote-directory ] [ local-file ]
  380. Prints an abbreviated listing of the contents of a directory on the 
  381. remote machine. If remote-directory is left unspecified, the 
  382. current working directory is used. If no local file is specified, or if 
  383. local-file is `-', the output is sent to the terminal.
  384.  
  385.  
  386. lls
  387. Works the same as the ls command except the local machine is 
  388. used.
  389.  
  390.  
  391. mdir remote-files local-file
  392. Like dir, except multiple remote files may be specified. If 
  393. interactive prompting is on, ftp will prompt the user to verify that 
  394. the last argument is indeed the target local file for receiving mdir 
  395. output.
  396.  
  397.  
  398. mget remote-files
  399. Expands the remote-files on the remote machine and does a get for 
  400. each file name thus produced. See glob for details on the filename 
  401. expansion. Resulting file names will then be processed according 
  402. to case, ntrans, and nmap settings. Files are transferred into the 
  403. local working directory, which can be changed with `lcd 
  404. directory'; new local directories can be created with `! mkdir 
  405. directory'.
  406.  
  407.  
  408. mkdir directory-name
  409. Makes a directory on the remote machine.
  410.  
  411.  
  412. mls remote-files local-file
  413. Like ls(1V), except multiple remote files may be specified. If 
  414. interactive prompting is on, ftp will prompt the user to verify that 
  415. the last argument is indeed the target local file for receiving mls 
  416. output.
  417.  
  418.  
  419. mode [ mode-name ]
  420. Sets the transfer mode to mode-name. The only valid mode-name 
  421. is stream, which corresponds to the default stream mode.
  422.  
  423.  
  424. more 
  425. Toggles the more mode status. When more mode is on, this 
  426. command breaks long directories into pages and prompts between 
  427. displaying them.
  428.  
  429.  
  430. open host [ port ]
  431. Establishes a connection to the specified host FTP server. An 
  432. optional port number may be supplied, in which case, ftp will 
  433. attempt to contact an FTP server at that port. If the auto-login option 
  434. is on (default), ftp will also attempt to automatically log the user in 
  435. to the FTP server (see below).
  436.  
  437.  
  438. prompt
  439. Toggles interactive prompting. Interactive prompting occurs 
  440. during multiple file transfers to allow the user to selectively 
  441. retrieve or store files. By default, prompting is turned on. If 
  442. prompting is turned off, any mget or mput will transfer all files, 
  443. and any mdelete will delete all files.
  444.  
  445.  
  446. put local-file [ remote-file]
  447. Stores a local file on the remote machine. If remote-file is left 
  448. unspecified, the local file name is used after processing according 
  449. to any ntrans or nmap settings in naming the remote file. File 
  450. transfer uses the current settings for representation type, file 
  451. structure, and transfer mode.
  452.  
  453.  
  454. pwd
  455. Prints the name of the current working directory on the remote 
  456. machine.
  457.  
  458.  
  459. quit
  460. Performs the same function as bye.
  461.  
  462.  
  463. quote arg1 arg2 ...
  464. Sends the arguments specified, verbatim, to the remote FTP 
  465. server. A single FTP reply code is expected in return.
  466.  
  467.  
  468. recv remote-file [ local-file]
  469. Performs the same function as get.
  470.  
  471.  
  472. remotehelp [ command-name ]
  473. Requests help from the remote FTP server. If a command-name is 
  474. specified it is supplied to the server as well.
  475.  
  476.  
  477. rename from to
  478. Renames the file "from" on the remote machine to "to."
  479.  
  480.  
  481. rmdir directory-name
  482. Deletes a directory on the remote machine.
  483.  
  484.  
  485. send local-file [ remote-file ]
  486. Performs the same function as put.
  487.  
  488.  
  489. sendport
  490. Toggles the use of PORT commands. By default, ftp will attempt to 
  491. use a PORT command when establishing a connection for each 
  492. data transfer. The use of PORT commands can prevent delays 
  493. when performing multiple file transfers. If the PORT command 
  494. fails, ftp will use the default data port. When the use of PORT 
  495. commands is disabled, no attempt will be made to use PORT 
  496. commands for each data transfer. This is useful when connected 
  497. to certain FTP implementations that ignore PORT commands but 
  498. incorrectly indicate they have been accepted.
  499.  
  500.  
  501. slashflip
  502. Toggles slashflipping command.
  503.  
  504.  
  505. status
  506. Shows the current status of ftp.
  507.  
  508.  
  509. struct [ struct-name ]
  510. Sets the file structure to struct-name. The only valid struct-name 
  511. is file, which corresponds to the default file structure.
  512.  
  513.  
  514. type [ type-name ]
  515. Sets the representation type to type-name. The valid type-names 
  516. are ascii for network ASCII, binary or image for image, and tenex 
  517. for local byte size with a byte size of 8 (used to talk to TENEX 
  518. machines). If no type is specified, the current type is printed. The 
  519. default type is network ASCII.
  520.  
  521.  
  522. user user-name [ password ] [ account ] 
  523. Identifies yourself to the remote FTP server. If the password is not 
  524. specified and the server requires it, ftp will prompt the user for it 
  525. (after disabling local echo). If an account field is not specified, 
  526. and the FTP server requires it, the user will be prompted for it. If 
  527. an account field is specified, an account command will be relayed 
  528. to the remote server after the login sequence is completed if the 
  529. remote server did not require it for logging in. Unless ftp is 
  530. invoked with auto-login disabled, this process is done 
  531. automatically on initial connection to the FTP server.
  532.  
  533.  
  534. verbose
  535. Toggles verbose mode. In verbose mode, all responses from the 
  536. FTP server are displayed to the user. In addition, if verbose mode 
  537. is on, when a file transfer completes, statistics regarding the 
  538. efficiency of the transfer are reported. By default, verbose mode is 
  539. on if ftp's commands are coming from a terminal, and off 
  540. otherwise.
  541.  
  542.  
  543. ? [ command ]
  544. Performs the same function as help.
  545.  
  546. Command arguments which have embedded spaces may be quoted 
  547. with quote (") marks.
  548.  
  549. If any command argument which is not indicated as being 
  550. optional is not specified, ftp will prompt for that argument.
  551.  
  552.  
  553. Aborting a File Transfer
  554. To abort a file transfer, use the terminal interrupt key (usually 
  555. CTRL-C). Sending transfers will be immediately halted. 
  556. Receiving transfers will be halted by sending a ftp protocol ABOR 
  557. command to the remote server, and discarding any further data 
  558. received. The speed at which this is accomplished depends upon the 
  559. remote server's support for ABOR processing. If the remote server 
  560. does not support the ABOR command, an ftp> prompt will not 
  561. appear until the remote server has completed sending the requested 
  562. file.
  563.  
  564. The terminal interrupt key sequence will be ignored when ftp has 
  565. completed any local processing and is awaiting a reply from the 
  566. remote server. A long delay in this mode may result from the 
  567. ABOR processing described above, or from unexpected behavior by 
  568. the remote server, including violations of the ftp protocol. If the 
  569. delay results from unexpected remote server behavior, the local ftp 
  570. program must be killed by hand.
  571.  
  572.  
  573. File Naming Conventions
  574. Local files specified as arguments to ftp commands are processed 
  575. according to the following rules.
  576.  
  577. 1.    If globbing is enabled, local file names are expanded according 
  578. to the rules used in the csh(1); see the glob command. If the ftp 
  579. command expects a single local file (for example, put), only the 
  580. first filename generated by the globbing operation is used.
  581.  
  582. 2.    For mget commands and get commands with unspecified local 
  583. file names, the local filename is the remote filename, which 
  584. may be altered by a case, ntrans, or nmap setting. The resulting 
  585. filename may then be altered if runique is on.
  586.  
  587. 3.    For mput commands and put commands with unspecified 
  588. remote file names, the remote filename is the local filename, 
  589. which may be altered by a ntrans or nmap setting. The 
  590. resulting filename may then be altered by the remote server if 
  591. sunique is on.
  592.  
  593.  
  594. File Transfer Parameters
  595. The FTP specification specifies many parameters which may 
  596. affect a file transfer.
  597.  
  598. The representation type may be one of network ASCII, EBCDIC, 
  599. image, or local byte size with a specified byte size (for PDP-10's 
  600. and PDP-20's mostly). The network ASCII and EBCDIC(rq types 
  601. have a further subtype which specifies whether vertical format 
  602. control (NEWLINE characters, form feeds, etc.) are to be passed 
  603. through (non-print), provided in TELNET format (TELNET 
  604. format controls), or provided in ASA (FORTRAN) (carriage 
  605. control (ASA)) format. ftp supports the network ASCII (subtype 
  606. non-print only) and image types, plus local byte size with a byte 
  607. size of 8 for communicating with TENEX machines.
  608.  
  609. The file structure may be one of file (no record structure), record, 
  610. or page. ftp supports only the default value, which is file.
  611.  
  612. The transfer mode may be one of stream, block, or compressed. ftp 
  613. supports only the default value, which is stream.
  614.  
  615.  
  616. lpq
  617.  
  618. Name
  619. lpq - display the queue of printer jobs.
  620.  
  621.  
  622. Command Line
  623. lpq [ -Pprinter ] [ -l ] [ + [ interval ] ] [ job# ... ] [ username ... ]
  624.  
  625.  
  626. Description
  627. lpq displays the contents of a printer queue. It reports the status of 
  628. jobs specified by job#, or all jobs owned by the user specified by 
  629. username. lpq reports on all jobs in the default printer queue when 
  630. invoked with no arguments.
  631.  
  632. For each print job in the queue, lpq reports the user's name, current 
  633. position, the names of input files comprising the job, the job 
  634. number (by which it is referred to when using lprm(1)) and the 
  635. total size in bytes. Normally, only as much information as will fit 
  636. on one line is displayed. Jobs are normally queued on a first-in-
  637. first-out basis. Filenames comprising a job may be unavailable, 
  638. such as when lpr is used at the end of a pipeline; in such cases the 
  639. filename field indicates ``(standard input)''.
  640.  
  641. If lpq warns that there is no daemon present (that is, due to some 
  642. malfunction), the lpc(8) command can be used to restart a printer 
  643. daemon.
  644.  
  645.  
  646. Options
  647. -P printer
  648. Displays information about the queue for the specified printer. In 
  649. the absence of the -P option, the queue to the printer specified by the 
  650. PRINTER variable in the environment is used. If the PRINTER 
  651. variable isn't set, the queue for the default printer is used.
  652.  
  653.  
  654. -l
  655. Displays queue information in long format; includes the name of 
  656. the host from which the job originated.
  657.  
  658.  
  659. +[interval]
  660. Displays the spool queue periodically until it empties. This option 
  661. clears the terminal screen before reporting on the queue. If an 
  662. interval is supplied, lpq sleeps that number of seconds in between 
  663. reports.
  664.  
  665.  
  666. Diagnostics
  667. Printer Is Ready and Printing
  668. The lpq program checks to see if there is a printer daemon. If the 
  669. daemon is hung, the super-user can abort the current daemon and 
  670. start a new one using lpc(8). Under some circumstances, lpq 
  671. reports that a printer is ready and printing when the daemon is, in
  672.  fact, hung.
  673.  
  674.  
  675. Waiting for Printer to Become Ready (offline ?)
  676. The daemon could not open the printer device. The printer may be 
  677. turned off-line. This message can also occur if a printer is out of 
  678. paper, the paper is jammed, and so on. Another possible cause is 
  679. that a process, such as an output filter, has exclusive use of the 
  680. device. The only recourse in this case is to kill the offending 
  681. process and restart the printer with lpc.
  682.  
  683.  
  684. Waiting for Host to Come Up
  685. A daemon is trying to connect to the remote machine named host, 
  686. in order to send the files in the local queue. If the remote machine 
  687. is up, lpd on the remote machine is probably dead or hung and 
  688. should be restarted using lpc.
  689.  
  690.  
  691. Sending to Host
  692. The files are being transferred to the remote host, or else the local 
  693. daemon has hung while trying to transfer the files.
  694.  
  695.  
  696. Warning:  Printer Is Down
  697. The printer has been marked as being unavailable with lpc.
  698.  
  699.  
  700. Warning: No Daemon Present
  701. The lpq process overseeing the spooling queue, as indicated in the 
  702. ``lock'' file in that directory, does not exist. This normally occurs 
  703. only when the daemon has unexpectedly died. Check the printer's 
  704. error log for a diagnostic from the deceased process; you can 
  705. restart the printer daemon with lpc.
  706.  
  707.  
  708. lpr
  709.  
  710. Name
  711. lpr - send a job to the printer
  712.  
  713.  
  714. Command Line
  715. lpr [ -Pprinter ] [ -#copies ] [ -Cclass ] [ -Jjob ] [ -Ttitle ] [ -i 
  716. [ indent ] ] [ -1234font ] [ -wcols ] [ -B ] [ -r ] [ -m ] [ -h ] [ -s ] 
  717. [ -filter-option ] [ filename ... ]
  718.  
  719.  
  720. Description
  721. lpr forwards printer jobs to a spooling area for subsequent printing 
  722. as facilities become available. Each printer job consists of copies of 
  723. (or, with -s , symbolic links to) each filename you specify. The 
  724. spool area is managed by the line printer daemon, lpd(8). lpr reads 
  725. from the standard input if no files are specified.
  726.  
  727.  
  728. Options
  729. -Pprinter
  730. Sends output to the named printer. Otherwise send output to the 
  731. printer named in the PRINTER environment variable, or to the 
  732. default printer, lp.
  733.  
  734.  
  735. -#copies
  736. Produces the number of copies indicated for each named file. For 
  737. example:
  738.  
  739.     example% lpr -#3 index.c lookup.c
  740.  
  741. produces three copies of index.c, followed by three copies of 
  742. lookup.c. On the other hand,
  743.  
  744.     example% cat index.c lookup.c | lpr
  745.  
  746. generates three copies of the concatenation of the files.
  747.  
  748.  
  749. -Cclass
  750. Prints class as the job classification on the burst page. For 
  751. example,
  752.  
  753.     example% lpr -C Operations new.index.c
  754.  
  755. replaces the system name (the name returned by hostname) with 
  756. ``Operations'' on the burst page, and prints the file new.index.c.
  757.  
  758.  
  759. -Jjob
  760. Prints job as the job name on the burst page. Normally, lpr uses the 
  761. first file's name.
  762.  
  763.  
  764. -T title
  765. Uses title instead of the file name for the title used by pr(1V).
  766.  
  767.  
  768. -i[indent]
  769. Indents output indent spaces. Eight spaces is the default.
  770.  
  771.     -1 font
  772.     -2 font
  773.     -3 font
  774.     -4 font
  775.  
  776.     Mounts the specified font on font position 1, 2, 3 or 4. The 
  777. daemon will construct a .railmag file in the spool directory that 
  778. indicates the mount by referencing /usr/lib/vfont/font.
  779.  
  780.  
  781. -wcols
  782. Uses cols as the page width for pr.
  783.  
  784.  
  785. -r
  786. Removes the file upon completion of spooling, or upon completion 
  787. of printing with the -s option.
  788.  
  789.  
  790. -m
  791. Sends mail upon completion.
  792.  
  793.  
  794. -h
  795. Suppresses printing the burst page.
  796.  
  797.  
  798. -s
  799. Creates a symbolic link from the spool area to the data files rather 
  800. than trying to copy them (so large files can be printed). This 
  801. means the data files should not be modified or removed until they 
  802. have been printed. In the absence of this option, files larger than 1 
  803. Megabyte in length are truncated. Note: the -s option only works on 
  804. the local host (files sent to remote printer hosts are copied anyway), 
  805. and only with named data files - it doesn't work if lpr is at the end 
  806. of a pipeline.
  807.  
  808.  
  809. filter-option
  810. The following single letter options notify the line printer spooler 
  811. that the files are not standard text files. The spooling daemon will 
  812. use the appropriate filters to print the data accordingly.
  813.  
  814.  
  815. -p 
  816. Uses pr to format the files (lpr-p is very much like pr | lpr).
  817.  
  818.  
  819. -l 
  820. Prints control characters and suppresses page breaks.
  821.  
  822.  
  823. -t 
  824. The files contain troff(1) (cat phototypesetter) binary data.
  825.  
  826.  
  827. -n 
  828. The files contain data from ditroff (device independent troff).
  829.  
  830.  
  831. -d
  832. The files contain data from tex (DVI format from Stanford).
  833.  
  834.  
  835. -g
  836. The files contain standard plot data as produced by the plot(3X) 
  837. routines (see also plot(1G) for the filters used by the printer 
  838. spooler).
  839.  
  840.  
  841. -v
  842. The files contain a raster image, see rasterfile (5).
  843.  
  844.  
  845. -c
  846. The files contain data produced by cifplot.
  847.  
  848.  
  849. -f
  850. Interprets the first character of each line as a standard FORTRAN 
  851. carriage control character. If no filter-option is given (and the 
  852. printer can interpret PostScript), the string `%!' as the first two 
  853. characters of a file indicates that it contains PostScript 
  854. commands.
  855.  
  856.  
  857. Diagnostics
  858. lpr: copy file is too large
  859. A file is determined to be too ``large'' to print by copying into the 
  860. spool area. Use the -s option as defined above to make a symbolic 
  861. link to the file instead of copying it. A too-large file is 
  862. approximately 1 Megabyte. lpr truncates the file, and prints as 
  863. much of it as it can.
  864.  
  865.  
  866. lpr: printer: unknown printer
  867. The printer was not found in the printcap database. Usually this is 
  868. a typing mistake; however, it may indicate a missing or incorrect 
  869. entry in the /etc/printcap file.
  870.  
  871.  
  872. lpr: printer: jobs queued, but cannot start daemon.
  873. The connection to lpd on the local machine failed. This usually 
  874. means the printer server started at boot time has died or is hung. 
  875. Check the local socket /dev/printer to be sure it still exists (if it does 
  876. not exist, there is no lpd process running).
  877.  
  878.  
  879. lpr: printer: printer queue is disabled
  880. This means the queue was turned off with
  881.  
  882.     example% /usr/etc/lpc disable printer
  883.  
  884. to prevent lpr from putting files in the queue. This is normally 
  885. done by the system manager when a printer is going to be down for 
  886. a long time. The printer can be turned back on by a super-user with 
  887. lpc.
  888.  
  889. If a connection to lpd on the local machine cannot be made lpr will 
  890. say that the daemon cannot be started. Diagnostics may be printed 
  891. in the daemon's log file regarding missing spool files by lpd
  892.  
  893.  
  894. lprm
  895.  
  896. Name
  897. lprm - remove jobs from the printer queue
  898.  
  899.  
  900. Command Line
  901. lprm [ -Pprinter ] [ - ] [ job # ... ] [ username ... ]
  902.  
  903.  
  904. Description
  905. lprm removes a job or jobs from a printer's spooling queue. Since 
  906. the spool directory is protected from users, using lprm is normally 
  907. the only method by which a user can remove a job.
  908.  
  909. Without any arguments, lprm deletes the job that is currently 
  910. active, provided that the user who invoked lprm owns that job.
  911.  
  912. You can remove a specific job by supplying its job number as an 
  913. argument, which you can obtain using lpq(1). For example:
  914.  
  915. example% lpq -Phost
  916. host is ready and printing
  917. Rank Owner Job Files Total Size
  918. active wendy 385 standard input 35501 bytes
  919. example% lprm -Phost 385
  920.  
  921. lprm reports the names of any files it removes, and is silent if 
  922. there are no applicable jobs to remove.
  923.  
  924. lprm kills the active printer daemon, if necessary, before 
  925. removing spooled jobs; it restarts the daemon when through.
  926.  
  927.  
  928. Options
  929. -Pprinter
  930. Specifies the queue associated with a specific printer. Otherwise the 
  931. value of the PRINTER variable in the environment is used. If this 
  932. variable is unset, the queue for the default printer is used.
  933.  
  934. Removes all jobs owned by you. If invoked by the super-user, all 
  935. jobs in the spool are removed. (Job ownership is determined by the 
  936. user's login name and host name on the machine where the lpr 
  937. command was invoked).
  938.  
  939.  
  940. Diagnostics
  941. lpr: printer: jobs queued, but cannot start daemon.
  942. The connection to lpd on the local machine failed. This usually 
  943. means the printer server started at boot time has died or is hung. If 
  944. it is hung, the master lpd(8) daemon may have to be killed and a 
  945. new one started.
  946.  
  947.  
  948. net14
  949.  
  950.  
  951. Name 
  952. net14 is a utility that redirects serial output onto a TCP/IP network.
  953.  
  954.  
  955. Command Line 
  956. net14 -h <filename> <program-name> [program options]
  957.  
  958.  
  959. Full Description
  960. net14 is a utility to allow programs which use interrupt 14h to output 
  961. serial information to output that information onto a TCP/IP 
  962. network. Thus, you could use this utility to re-direct the output from 
  963. MS-Kermit onto a TCP/IP network through an ethernet card, while 
  964. still retaining the MS-Kermit user interface.
  965.  
  966.  
  967. Usage
  968. The net14 program acts as a shell in which you can execute another 
  969. program. net14 first initializes the network and reads in the 
  970. config.tel file, then transfers control to the program specified on 
  971. the command line. For example, the following line starts net14, 
  972. specifies a location for the config.tel file, and fires up MS-Kermit:
  973.  
  974. net14 -h c:\ncsa\config.tel kermit
  975.  
  976. To pass parameters to the program which net14 transfers control to, 
  977. place them after the filename of the program.
  978.  
  979.  
  980. Options
  981. -h <filename>
  982. Specifies the location of the config.tel file to read in the network 
  983. options.
  984.  
  985.  
  986. <program-name> 
  987. The program which net14 executes after initializing the network. 
  988. net14 searches for the program in the path specified in the MS-DOS 
  989. PATH environment variable.
  990.  
  991.  
  992. [program options] 
  993. This program passes options to the program which net14 executes.
  994.  
  995.  
  996. rsh
  997.  
  998.  
  999. Name
  1000. rsh - remote shell
  1001.  
  1002.  
  1003. Command Line
  1004. rsh [ -l username ] [ -n ] hostname command
  1005.  
  1006. rsh hostname [ -l username ] [ -n ] command
  1007.  
  1008. hostname [ -l username ] [ -n ] command
  1009.  
  1010.  
  1011. Description
  1012. rsh connects to the specified hostname and executes the specified 
  1013. command. rsh copies its standard input to the remote command, 
  1014. the standard output of the remote command to its  standard output, 
  1015. and the standard error of the remote command to its standard 
  1016. error. Interrupt, quit and terminate signals are propagated to the 
  1017. remote command; rsh normally terminates when the remote 
  1018. command does.
  1019.  
  1020. If you omit the command, instead of executing a single command, 
  1021. rsh logs you in on the remote host using rlogin(1C). Shell 
  1022. metacharacters which are not quoted are interpreted on the local 
  1023. machine, while quoted metacharacters are interpreted on the 
  1024. remote machine.
  1025.  
  1026. Hostnames are given in the hosts database, which may be 
  1027. contained  in the /etc/hosts file, the Yellow Pages hosts database, 
  1028. the Internet domain name database, or some combination of the 
  1029. three. Each host has one official name (the first name in the 
  1030. database entry) and optionally one or more nicknames. Official 
  1031. hostnames or nicknames may be given as hostname.
  1032.  
  1033. If the name of the file from which rsh is executed is anything other 
  1034. than ``rsh,'' rsh takes this name as its hostname argument. This 
  1035. allows you to create a symbolic link to rsh in the name of a host 
  1036. which, when executed, will invoke a remote shell on that host. The 
  1037. /usr/hosts directory is provided to be populated with symbolic links 
  1038. in the names of commonly used hosts. By  including /usr/hosts in 
  1039. your shell's search path, you can run rsh by typing hostname to 
  1040. your shell.
  1041.  
  1042. Each remote machine may have a file named /etc/hosts.equiv that 
  1043. contains a list of trusted hostnames with which it shares 
  1044. usernames. Anyone with identical usernames on the local and 
  1045. remote machines may rsh from the machines listed in the remote 
  1046. machine's /etc/hosts file. Each user can set up a similar private 
  1047. equivalence list using the file .rhosts in their home directories. 
  1048. Each line in this file contains (at least) a hostname, a separating 
  1049. space, and a username. The entry permits the user named 
  1050. username who is logged into hostname to use rsh to access the 
  1051. remote machine as the remote user. If the name of the local host is 
  1052. not found in the /etc/hosts.equiv file on the remote machine, and 
  1053. the local username and hostname are not found in the remote 
  1054. user's .rhosts file, then the access is denied. The hostnames listed 
  1055. in the /etc/hosts.equiv and .rhosts files must be the official 
  1056. hostnames listed in the hosts database. You cannot use nicknames 
  1057. in either of these files. Unless the command argument is omitted, 
  1058. rsh will not prompt you for a password if the remote machine 
  1059. denies you access.
  1060.  
  1061.  
  1062. Options
  1063. -l  username
  1064. Uses the username as the remote username instead of your local 
  1065. username. Without this option, the remote username and your 
  1066. local username are identical.
  1067.  
  1068.  
  1069. -n
  1070. Redirects the input of rsh to /dev/null. Occasionally, you must use 
  1071. this option to avoid unfortunate interactions between rsh and the 
  1072. shell which invokes it. For example, if you are running rsh and 
  1073. invoke a rsh in the background without redirecting its input away 
  1074. from the terminal, it will block even if the remote command 
  1075. doesn't post any reads. The -n option prevents this situation.
  1076.  
  1077. Your entry in the file /etc/passwd on the remote system determines 
  1078. the type of remote shell (sh, rsh, or other) your local system will 
  1079. use.
  1080.  
  1081.  
  1082. setclock
  1083.  
  1084.  
  1085. Name
  1086. setclock sets the local clock to one on a network server.
  1087.  
  1088.  
  1089. Command Line
  1090. setclock -h <filename> hostname
  1091.  
  1092.  
  1093. Description
  1094. The utility, setclock, sets the PC's local clock from the network's 
  1095. clock server.
  1096.  
  1097.  
  1098. Options
  1099. -h <filename>  
  1100. Gives the location and the name of the config.tel file.
  1101.  
  1102.  
  1103. hostname
  1104. Gives the name of the host from which you'll get the time.
  1105.