home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V7 / usr / doc / summary / hel1 < prev    next >
Encoding:
Text File  |  1979-01-10  |  17.2 KB  |  786 lines

  1. .SH
  2. B.  Hardware
  3. .PP
  4. The
  5. 7th edition
  6. .UC UNIX
  7. operating system
  8. runs on
  9. a DEC PDP-11/45 or 11/70*
  10. .FS
  11. *PDP is a Trademark of Digital Equipment Corporation.
  12. .FE
  13. with at least the following equipment:
  14. .IP
  15. 128K to 2M words of managed memory; parity not used.
  16. .IP
  17. disk: RP03, RP04, RP06, RK05 (more than 1 RK05) or equivalent.
  18. .IP
  19. console typewriter.
  20. .IP
  21. clock: KW11-L or KW11-P.
  22. .LP
  23. The following equipment is strongly recommended:
  24. .IP
  25. communications controller such as DL11 or DH11.
  26. .IP
  27. full duplex 96-character ASCII terminals.
  28. .IP
  29. 9-track tape or extra disk for system backup.
  30. .LP
  31. The system is normally distributed on 9-track tape.
  32. The minimum memory and disk space specified is enough to run
  33. and maintain
  34. .UC UNIX .
  35. More will be needed to keep all source on line, or to handle
  36. a large number of users,
  37. big data bases, diversified complements of devices, or large
  38. programs.
  39. The resident code
  40. occupies 12-20K words depending
  41. on configuration;
  42. system data occupies 10-28K words.
  43. .PP
  44. There is no commitment to provide 7th edition
  45. .UC UNIX
  46. on PDP-11/34, 11/40 and 11/60 hardware.
  47. .SH
  48. C.  Software
  49. .PP
  50. Most of the programs available as
  51. .UC UNIX
  52. commands are listed.
  53. Source code and printed manuals are 
  54. distributed for all of the listed software
  55. except games.
  56. Almost all of the code is written in C.
  57. Commands are self-contained and do not require extra setup
  58. information,
  59. unless specifically noted as ``interactive.''
  60. Interactive programs can be made to run from a prepared script
  61. simply by redirecting input.
  62. Most programs intended for interactive use
  63. (e.g., the editor) 
  64. allow for an escape to
  65. command level (the Shell).
  66. Most file processing commands
  67. can also go from standard input to standard output
  68. (``filters'').
  69. The piping facility of the Shell may be used
  70. to connect such filters directly to the input or output
  71. of other programs.
  72. .NH
  73. Basic Software
  74. .PP
  75. This
  76. includes the time-sharing operating
  77. system with utilities, a machine language assembler and a 
  78. compiler for the programming language C\(emenough
  79. software to
  80. write and run new applications
  81. and to maintain or modify
  82. .UC UNIX
  83. itself.
  84. .NH 2
  85. Operating System
  86. .sh UNIX
  87. The basic resident code
  88. on which everything else depends.
  89. Supports the system calls, and maintains the file system.
  90. A general description of
  91. .UC UNIX
  92. design
  93. philosophy and system facilities appeared in
  94. the Communications of the ACM, July, 1974.
  95. A more extensive survey is in the Bell System Technical Journal
  96. for July-August 1978.
  97. Capabilities include:
  98. .op
  99. Reentrant code for user processes.
  100. .op
  101. Separate instruction and data spaces.
  102. .op
  103. ``Group'' access permissions for cooperative projects,
  104. with overlapping memberships.
  105. .op
  106. Alarm-clock timeouts.
  107. .op
  108. Timer-interrupt sampling and interprocess monitoring
  109. for debugging and measurement.
  110. .OP
  111. Multiplexed I/O for machine-to-machine communication.
  112. .sh DEVICES
  113. All I/O is logically synchronous.
  114. I/O devices are simply files in the file system.
  115. Normally, invisible buffering makes all physical
  116. record structure and device characteristics transparent and exploits the
  117. hardware's ability to do overlapped I/O.
  118. Unbuffered physical record
  119. I/O is available for unusual applications.
  120. Drivers for these devices are
  121. available; others can be easily written:
  122. .op
  123. Asynchronous interfaces: DH11, DL11.
  124. Support for most common ASCII terminals.
  125. .op
  126. Synchronous interface: DP11.
  127. .op
  128. Automatic calling unit interface: DN11.
  129. .op
  130. Line printer: LP11.
  131. .op
  132. Magnetic tape: TU10 and TU16.
  133. .op
  134. DECtape: TC11.
  135. .op
  136. Fixed head disk: RS11, RS03 and RS04.
  137. .op
  138. Pack type disk: RP03, RP04, RP06;
  139. minimum-latency seek scheduling.
  140. .op
  141. Cartridge-type disk: RK05, one or more physical devices per
  142. logical device.
  143. .op
  144. Null device.
  145. .op
  146. Physical memory of PDP-11, or mapped memory in resident system.
  147. .op
  148. Phototypesetter: Graphic Systems System/1 through DR11C.
  149. .sh BOOT
  150. Procedures to get
  151. .UC UNIX
  152. started.
  153. .sh MKCONF
  154. Tailor device-dependent system code to hardware configuration.
  155. As distributed,
  156. .UC UNIX
  157. can 
  158. be brought up directly on any acceptable CPU
  159. with any acceptable disk, any sufficient amount of core,
  160. and either clock.
  161. Other changes, such as optimal
  162. assignment of directories to devices, inclusion of floating
  163. point simulator, or installation of device names in file system,
  164. can then be made at leisure.
  165. .NH 2
  166. User Access Control
  167. .LP
  168. .sh LOGIN
  169. Sign on as a new user.
  170. .op
  171. Verify password and establish user's 
  172. individual and group (project) identity.
  173. .op
  174. Adapt to characteristics of terminal.
  175. .op
  176. Establish working directory.
  177. .op
  178. Announce presence of mail (from MAIL).
  179. .op
  180. Publish message of the day.
  181. .op
  182. Execute user-specified profile.
  183. .op
  184. Start command interpreter or other initial program.
  185. .sh PASSWD
  186. Change a password.
  187. .op
  188. User can change his own password.
  189. .op
  190. Passwords are kept encrypted for security.
  191. .sh NEWGRP
  192. Change working group (project).
  193. Protects against unauthorized changes to projects.
  194. .NH 2
  195. Terminal Handling
  196. .LP
  197. .sh TABS
  198. Set tab stops appropriately for specified terminal type.
  199. .sh STTY
  200. Set up options for optimal control of a terminal.
  201. In so far as they are deducible from the input, these
  202. options are set automatically by LOGIN.
  203. .op
  204. Half vs. full duplex.
  205. .op
  206. Carriage return+line feed vs. newline.
  207. .op
  208. Interpretation of tabs.
  209. .op
  210. Parity.
  211. .op
  212. Mapping of upper case to lower.
  213. .op
  214. Raw vs. edited input.
  215. .op
  216. Delays for tabs, newlines and carriage returns.
  217. .NH 2
  218. File Manipulation
  219. .LP
  220. .sh CAT
  221. Concatenate one or more files onto standard output.
  222. Particularly used for unadorned printing, for
  223. inserting data into a pipeline,
  224. and for buffering output that comes in dribs and drabs.
  225. Works on any file regardless of contents.
  226. .sh CP
  227. Copy one file to another,
  228. or a set of files to a directory.
  229. Works on any file regardless of contents.
  230. .sh PR
  231. Print files with title, date, and page number on every page.
  232. .op
  233. Multicolumn output.
  234. .op
  235. Parallel column merge of several files.
  236. .sh LPR
  237. Off-line print.
  238. Spools arbitrary files to the line printer.
  239. .sh CMP
  240. Compare two files and report if different.
  241. .sh TAIL
  242. Print last
  243. .I n
  244. lines of input
  245. .op
  246. May print last
  247. .I n
  248. characters, or from
  249. .I n
  250. lines or characters to end.
  251. .sh SPLIT
  252. Split a large file into more manageable pieces.
  253. Occasionally necessary for editing (ED).
  254. .sh DD
  255. Physical file format translator,
  256. for exchanging data with foreign
  257. systems, especially IBM 370's.
  258. .sh SUM
  259. Sum the words of a file.
  260. .NH 2
  261. Manipulation of Directories and File Names
  262. .LP
  263. .sh RM
  264. Remove a file.
  265. Only the name goes away if any other names are linked to the file.
  266. .OP
  267. Step through a directory deleting files interactively.
  268. .OP
  269. Delete entire directory hierarchies.
  270. .sh LN
  271. ``Link'' another name (alias) to an existing file.
  272. .sh MV
  273. Move a file or files.
  274. Used for renaming files.
  275. .sh CHMOD
  276. Change permissions on one or more files.
  277. Executable by files' owner.
  278. .sh CHOWN
  279. Change owner of one or more files.
  280. .sh CHGRP
  281. Change group (project) to which a file belongs.
  282. .sh MKDIR
  283. Make a new directory.
  284. .sh RMDIR
  285. Remove a directory.
  286. .sh CD
  287. Change working directory.
  288. .sh FIND
  289. Prowl the directory
  290. hierarchy finding
  291. every file that meets
  292. specified criteria.
  293. .op
  294. Criteria include:
  295. .in +2
  296. .nf
  297. name matches a given pattern,
  298. creation date in given range,
  299. date of last use in given range,
  300. given permissions,
  301. given owner,
  302. given special file characteristics,
  303. boolean combinations of above.
  304. .in -2
  305. .fi
  306. .op
  307. Any directory may be considered to be the root.
  308. .op
  309. Perform specified command on each file found.
  310. .NH 2
  311. Running of Programs
  312. .LP
  313. .sh SH
  314. The Shell, or command language interpreter.
  315. .op
  316. Supply arguments to and run any executable program.
  317. .op
  318. Redirect standard input, standard output, and standard error files.
  319. .op
  320. Pipes:
  321. simultaneous execution with output of one process connected
  322. to the input of another.
  323. .OP
  324. Compose compound commands using:
  325. .in+2
  326. if ... then ... else,
  327. .br
  328. case switches,
  329. .br
  330. while loops,
  331. .br
  332. for loops over lists,
  333. .br
  334. break, continue and exit,
  335. .br
  336. parentheses for grouping.
  337. .in -2
  338. .op
  339. Initiate background processes.
  340. .op
  341. Perform Shell programs, i.e., command scripts with
  342. substitutable arguments.
  343. .op
  344. Construct argument lists from all file names
  345. satisfying specified patterns.
  346. .OP
  347. Take special action on traps and interrupts.
  348. .OP
  349. User-settable search path for finding commands.
  350. .OP
  351. Executes user-settable profile upon login.
  352. .OP
  353. Optionally announces presence of mail as it arrives.
  354. .op
  355. Provides variables and parameters with default setting.
  356. .sh TEST
  357. Tests for use in Shell conditionals.
  358. .op
  359. String comparison.
  360. .op
  361. File nature and accessibility.
  362. .op
  363. Boolean combinations of the above.
  364. .sh EXPR
  365. String computations for calculating command arguments.
  366. .OP
  367. Integer arithmetic
  368. .OP
  369. Pattern matching
  370. .sh WAIT
  371. Wait for termination of asynchronously running processes.
  372. .sh READ
  373. Read a line from terminal,
  374. for interactive Shell procedure.
  375. .sh ECHO
  376. Print remainder of command line.
  377. Useful for diagnostics or prompts in Shell programs,
  378. or for inserting data into a pipeline.
  379. .sh SLEEP
  380. Suspend execution for a specified time.
  381. .sh NOHUP
  382. Run a command immune to hanging up the terminal.
  383. .sh NICE
  384. Run a command in low (or high) priority.
  385. .sh KILL
  386. Terminate named processes.
  387. .sh CRON
  388. Schedule regular actions at specified times.
  389. .op
  390. Actions are arbitrary programs.
  391. .op
  392. Times are
  393. conjunctions of month, day of month, day of week, hour
  394. and minute.
  395. Ranges are specifiable for each.
  396. .sh AT
  397. Schedule a one-shot action for an arbitrary time.
  398. .sh TEE
  399. Pass data between processes and divert a copy into one or more files.
  400. .NH 2
  401. Status Inquiries
  402. .LP
  403. .sh LS
  404. List the names of one, several, or all files in one or more directories.
  405. .op
  406. Alphabetic or temporal sorting, up or down.
  407. .op
  408. Optional information:
  409. size,
  410. owner,
  411. group,
  412. date last modified,
  413. date last accessed,
  414. permissions,
  415. i-node number.
  416. .sh FILE
  417. Try to determine 
  418. what kind of information is in a file by consulting
  419. the file system index and by reading the file itself.
  420. .sh DATE
  421. Print today's date and time.
  422. Has considerable knowledge
  423. of calendric and horological peculiarities.
  424. .op
  425. May set
  426. .UC UNIX 's
  427. idea of date and time.
  428. .sh DF
  429. Report amount of free space on file system devices.
  430. .sh DU
  431. Print a summary of total space occupied by all files in a hierarchy.
  432. .sh QUOT
  433. Print summary of file space usage by user id.
  434. .sh WHO
  435. Tell who's on the system.
  436. .op
  437. List of presently logged in users,
  438. ports and times on.
  439. .op
  440. Optional history of all logins and logouts.
  441. .sh PS
  442. Report on active processes.
  443. .op
  444. List your own or everybody's processes.
  445. .op
  446. Tell what commands are being executed.
  447. .op
  448. Optional status information:
  449. state and scheduling info,
  450. priority,
  451. attached terminal,
  452. what it's waiting for,
  453. size.
  454. .sh IOSTAT
  455. Print statistics about system I/O activity.
  456. .sh TTY
  457. Print name of your terminal.
  458. .sh PWD
  459. Print name of your working directory.
  460. .NH 2
  461. Backup and Maintenance
  462. .LP
  463. .sh MOUNT
  464. Attach a device containing
  465. a file system to
  466. the tree of directories.
  467. Protects against nonsense arrangements.
  468. .sh UMOUNT
  469. Remove the file system contained on a device
  470. from the tree of directories.
  471. Protects against removing a busy device.
  472. .sh MKFS
  473. Make a new file system on a device.
  474. .sh MKNOD
  475. Make an i-node (file system entry) for a special file.
  476. Special files are
  477. physical devices,
  478. virtual devices, physical memory, etc.
  479. .sh TP
  480. .sh TAR
  481. Manage file archives on magnetic tape or DECtape.
  482. TAR is newer.
  483. .op
  484. Collect files into an archive.
  485. .op
  486. Update DECtape archive by date.
  487. .op
  488. Replace or delete DECtape files.
  489. .op
  490. Print table of contents.
  491. .op
  492. Retrieve from archive.
  493. .sh DUMP
  494. Dump the file system
  495. stored on a specified device, selectively by date, or indiscriminately.
  496. .sh RESTOR
  497. Restore a dumped file system,
  498. or selectively retrieve parts thereof.
  499. .sh SU
  500. Temporarily become the super user with all the rights and privileges
  501. thereof.
  502. Requires a password.
  503. .sh DCHECK
  504. .sh ICHECK
  505. .sh NCHECK
  506. Check consistency of file system.
  507. .op
  508. Print gross statistics:
  509. number of files,
  510. number of directories,
  511. number of special files,
  512. space used,
  513. space free.
  514. .op
  515. Report duplicate use of space.
  516. .op
  517. Retrieve lost space.
  518. .op
  519. Report inaccessible files.
  520. .op
  521. Check consistency of directories.
  522. .op
  523. List names of all files.
  524. .sh CLRI
  525. Peremptorily expunge a file and its space from a file system.
  526. Used to repair damaged file systems.
  527. .sh SYNC
  528. Force all outstanding I/O on the system to completion.
  529. Used to shut down gracefully.
  530. .NH 2
  531. Accounting
  532. .LP
  533. The timing information on which the reports are based can be
  534. manually cleared or shut off completely.
  535. .sh AC
  536. Publish cumulative connect time report.
  537. .op
  538. Connect time by user or by day.
  539. .op
  540. For all users or for selected users.
  541. .sh SA
  542. Publish Shell accounting
  543. report.
  544. Gives usage information on each command executed.
  545. .op
  546. Number of times used.
  547. .op
  548. Total system time, user time and elapsed time.
  549. .op
  550. Optional averages and percentages.
  551. .op
  552. Sorting on various fields.
  553. .NH 2
  554. Communication
  555. .LP
  556. .sh MAIL
  557. Mail a message to one or more users.
  558. Also used to read and dispose of incoming mail.
  559. The presence of mail is announced by LOGIN
  560. and optionally by SH.
  561. .op
  562. Each message can be disposed of individually.
  563. .op
  564. Messages can be saved in files or forwarded.
  565. .sh CALENDAR
  566. Automatic reminder service for events of today and tomorrow.
  567. .sh WRITE
  568. Establish direct terminal communication with another user.
  569. .sh WALL
  570. Write to all users.
  571. .sh MESG
  572. Inhibit receipt of messages from WRITE and WALL.
  573. .sh CU
  574. Call up another time-sharing system.
  575. .OP
  576. Transparent interface to remote machine.
  577. .OP
  578. File transmission.
  579. .OP
  580. Take remote input from local file or put remote output
  581. into local file.
  582. .OP
  583. Remote system need not be
  584. .UC UNIX .
  585. .sh UUCP
  586. .UC UNIX
  587. to
  588. .UC UNIX
  589. copy.
  590. .OP
  591. Automatic queuing until line becomes available
  592. and remote machine is up.
  593. .OP
  594. Copy between two remote machines.
  595. .op
  596. Differences, mail, etc., between two machines.
  597. .NH 2
  598. Basic Program Development Tools
  599. .LP
  600. Some of these utilities are used as integral parts of
  601. the higher level languages described in section 2.
  602. .sh AR
  603. Maintain archives and libraries.
  604. Combines several files into one for housekeeping efficiency.
  605. .op
  606. Create new archive.
  607. .op
  608. Update archive by date.
  609. .op
  610. Replace or delete files.
  611. .op
  612. Print table of contents.
  613. .op
  614. Retrieve from archive.
  615. .sh AS
  616. Assembler.
  617. Similar to PAL-11, but different in detail.
  618. .op
  619. Creates object program consisting of
  620. .in+2
  621. .nf
  622. code, possibly read-only,
  623. initialized data or read-write code,
  624. uninitialized data.
  625. .in -2
  626. .fi
  627. .op
  628. Relocatable object code is directly executable without
  629. further transformation.
  630. .op
  631. Object code normally includes a symbol table.
  632. .op
  633. Multiple source files.
  634. .op
  635. Local labels.
  636. .op
  637. Conditional assembly.
  638. .op
  639. ``Conditional jump'' instructions become
  640. branches or branches plus jumps depending on distance.
  641. .sh Library
  642. The basic run-time library.
  643. These routines are used freely by all software.
  644. .op
  645. Buffered character-by-character I/O.
  646. .op
  647. Formatted input and output conversion (SCANF and PRINTF)
  648. for standard input and output, files, in-memory conversion.
  649. .op
  650. Storage allocator.
  651. .op
  652. Time conversions.
  653. .op
  654. Number conversions.
  655. .op
  656. Password encryption.
  657. .op
  658. Quicksort.
  659. .op
  660. Random number generator.
  661. .op
  662. Mathematical function library, including
  663. trigonometric functions and inverses,
  664. exponential, logarithm, square root,
  665. bessel functions.
  666. .sh ADB
  667. Interactive debugger.
  668. .op
  669. Postmortem dumping.
  670. .OP
  671. Examination of arbitrary files, with no limit on size.
  672. .op
  673. Interactive breakpoint debugging with the debugger as a separate
  674. process.
  675. .OP
  676. Symbolic reference to local and global variables.
  677. .op
  678. Stack trace for C programs.
  679. .OP
  680. Output formats:
  681. .in+2
  682. .nf
  683. 1-, 2-, or 4-byte integers in octal, decimal, or hex
  684. .br
  685. single and double floating point
  686. .br
  687. character and string
  688. .br
  689. disassembled machine instructions
  690. .br
  691. .fi
  692. .in-2
  693. .op
  694. Patching.
  695. .OP
  696. Searching for integer, character, or floating patterns.
  697. .OP
  698. Handles separated instruction and data space.
  699. .sh OD
  700. Dump any file.
  701. Output options include any combination of
  702. octal or decimal by words,
  703. octal by bytes,
  704. ASCII,
  705. opcodes,
  706. hexadecimal.
  707. .op
  708. Range of dumping is controllable.
  709. .sh LD
  710. Link edit.
  711. Combine relocatable object files.
  712. Insert required routines from specified libraries.
  713. .op
  714. Resulting code may be sharable.
  715. .op
  716. Resulting code may have separate instruction and data spaces.
  717. .sh LORDER
  718. Places object file names in proper order for loading,
  719. so that files depending on others come after them.
  720. .sh NM
  721. Print the namelist (symbol table) of an object program.
  722. Provides control over the style and order of
  723. names that are printed.
  724. .sh SIZE
  725. Report the core requirements
  726. of one or more object files.
  727. .sh STRIP
  728. Remove the relocation and symbol table information from
  729. an object file to save space.
  730. .sh TIME
  731. Run a command and report timing information on it.
  732. .sh PROF
  733. Construct a profile of time spent per routine
  734. from statistics gathered by time-sampling the
  735. execution of a program.
  736. Uses floating point.
  737. .op
  738. Subroutine call frequency and average times for C programs.
  739. .sh MAKE
  740. Controls creation of large programs.
  741. Uses a control file specifying source file dependencies
  742. to make new version;
  743. uses time last changed to deduce minimum amount of work necessary.
  744. .op
  745. Knows about CC, YACC, LEX, etc.
  746. .NH 2
  747. UNIX Programmer's Manual
  748. .LP
  749. .sh Manual
  750. Machine-readable version of the
  751. .UC UNIX
  752. Programmer's Manual.
  753. .op
  754. System overview.
  755. .op
  756. All commands.
  757. .op
  758. All system calls.
  759. .op
  760. All subroutines in C and assembler libraries.
  761. .op
  762. All devices and other special files.
  763. .op
  764. Formats of file system and kinds
  765. of files known to system software.
  766. .op
  767. Boot and maintenance procedures.
  768. .sh MAN
  769. Print specified manual section on your terminal.
  770. .NH 2
  771. Computer-Aided Instruction
  772. .LP
  773. .sh LEARN
  774. A program for interpreting CAI scripts, plus scripts
  775. for learning about 
  776. .UC UNIX
  777. by using it.
  778. .op
  779. Scripts for basic files and commands,
  780. editor,
  781. advanced files and commands,
  782. .UC EQN ,
  783. .UC MS
  784. macros,
  785. C programming language.
  786.