Heurikon UNIX System V & V.2 Reference Guide HElRIK9N Microcomputers For Industry Heurikon t~!X - Reference Guide System V and V.2 Heurikon Corporation 3201 Latham Drive Madison, WI 53713 (608)-271-8700 Apr 1987 Rev D The information in this guide has been checked and is believed to be accurate and reliable. HOWEVER, NO RESPONSIBILITY IS ASSUMED BY HEURIKON FOR ITS USE OR FOR ANY INACCURACIES. Specifications are subject to change without notice. HEURIKON DOES NOT ASSUME ANY LIABILITY ARISING OUT OF USE OR OTHER APPLICATION OF ANY PRODUCT, CIRCUIT OR PROGRAM DESCRIBED HEREIN. This document does not convey any license under Heurikon's patents or the rights of others. Copyright 1987 Heurikon Corporation Madison, WI Heurikon u~IX - Reference Guide Heurikon Corporation Madison, WI 1. BOOTING THE SySTEM •••••••••••••••••••••••••••••••••••••••••••••• 2 1.1 Winchester Booting ••••••••••••••••••••••••••••••••••••••• 3 1.2 Floppy Booting ••••••••••••••••••••••••••••••••••••••••••• 12 1.3 Initial System Configuration ••••••••••••••••••••••••••••• 13 2. POWER-DOWN PROCEDURE •••••••••••••••••••••••••••••••••••••••••••• 14 3. IN CASE OF TROUBLE •••••••••••••••••••••••••••••••••••••••••••••• 15 3.1 Cannot Boot •••••••••••••••••••••••••••••••••••••••••••••• 15 3.2 Programs that Don't Work ••••••••••••••••••••••••••••••••• 15 3.3 Terminal or System Lockups ••••••••••••••••••••••••••••••• 17 3.4 System Crashes ••••••••••••••••••••••••••••••••••••••••••• 18 3.5 Other Problems ••••••••••••••••••••••••••••••••••••••••••• 18 3.6 Reporting Bugs ••••••••••••••••••••••••••••••••••••••••••• 20 4. THE UNIX MANUALS................................................ 21 4.1 User's Manual............................................ 21 4.2 Adminiscrator~s Manual................................... 2S 4.3 User Guide............................................... 25 4.4 Programming Guide........................................ 25 4.5 Support Tools Guide...................................... 26 4.6 Document Processing Guide................................ 26 4.7 Administrator Guide...................................... 26 5. T~ UNIX FILE SySTEM............................................ 27 5.1 Structure, File and Directory Names...................... 27 5.2 Creating Directories and Files........................... 28 5.3 Typical Organization..................................... 29 5.4 Owners and Permissions................................... 30 5.5 Repairing a Damaged File System.......................... 30 6. TOUR OF IMPORTANT FILES......................................... 31 6.1 /etc/passwd.............................................. 31 6.2 /etc/inittab............................................. 32 6.3 /etc/gettydefs........................................... 33 6.4 /etc/rc.................................................. 34 6.5 C-Shell Login Scripts.................................... 35 6.6 Bourne-Shell Login Scripts............................... 37 6.7 /etc/termcap and terminfo................................ 38 6.8 The Clock Daemon......................................... 38 6.9 News..................................................... 40 6.10 /etc/motd................................................ 41 6.11 /dev..................................................... 41 7. THE S~LL •••••••••••••••••••••••••••••••••••••••••••••••••• ••••• 42 - i - 7.1 Csh Alias Feature •••••••••••••••••••••••••••••••••••••••• 42 7.2 Csh History Feature •••••••••••••••••••••••••••••••••••••• 42 7.3 Wild Cards and Expansions •••••••••••••••••••••••••••••••• 43 7.4 Shell Scripts •••••••••••••••••••••••••••••••••••••••••••• 43 7.5 Special Characters ••••••••••••••••••••••••••••••••••••••• 46 7.6 Redirection of I/O and Pipes ••••••••••••••••••••••••••••• 47 7.7 Background Commands •••••••••••••••••••••••••••••••••••••• 49 7.8 Use of Shell Variables ••••••••••••••••••••••••••••••••••• 50 7.9 Shell Layering ••••••••••••••••••••••••••••••••••••••••••• 51 8. INTERESTING COMMANDS •••••••••••••••••••••• -••••••••••••• _••••••••• 52 8.1 Process Status ••••••••••••••••••••••••••••••••••••••••••• 52 8.2 Change Directory and List •••••••••••••••••• -•••••••••••••• 52 8.3 Change Directory and Print Working Directory ••••••••••••• 52 8.4 Pattern Search ••••••••••••••••••••••••••••••••••••••••••• 52 8.5 Display File Contents •••••••••••••••••••••••••••••••••••• 52 8.6 Display Who is Logged On ••••••••••••••••••••••••••••••••• 53 8.7 Sleep~ •••••••••••••••••••••••••••••••••••••••••••••••• ••• 53 8.8 Display Environment and Shell Variables •••••••••••••••••• 53 8.9 Date and Time •••••••••••••••••••••••••••••••••••••••••••• 53 8.10 Translate Characters ••••••••••••••••••••••••••••••••••••• 53 8.11 Copy. Move and Remove •••••••••••••••••••••••••••••••••••• 53 8.12 Display File Types ••••••••••••••••••••••••••••••••••••••• 53 8.13 Check Spelling •••••••••••••••••••••••••••••• 0 ••••••••••••• 53 8.14 Echo Arguments ••••••••••••••••••••••••••••••••••••••••••• 54 8.15 Time a Command ••••••••••••••••••••••••••••••••••••••••••• 54 8.16 Send Mail •••••••••••••••••••••••••••••••••••••••••••••••• 54 8.17 Display Terminal Options ••••••••••••••••••••••••••••••••• 54 8.18 Repeat the Previous Command •••••••••••••••••••••••••••••• 54 8.19 Display History and Aliases •••••••••••••••••••••••••••••• 54 8.20 Correcting Simple Errors ••••••••••••••••••••••••••••••••• 54 8.21 Repeating a Command •••••••••••••••••••••••••••••••••••••• 54 8.22 Head and Tail •••••••••••••••••••••••••••••••••••••••••••• 54 9. OTHER THINGS TO LEARN (TOOLS) ••••••••••••••••••••••••••••••••••• 55 9.1 Summary •••••••••••••••••••••••••••••••••••••••••••••••••• 55 9.2 Move vs. Copy vs Link •••••••••••••••••••••••••••••••••••• 56 9.3 The Visual Editor •••••••••••••••••••••••••••••••••••••••• 57 9.4 Other UNIX Editors ••••••••••••••••••••••••••••••••••••••• 59 9.5 Compiling a 'c' Program •••••••••••••••••••••••••••••••••• 60 9.6 Linking C, FORTRAN, Pascal and Assembler Programs •••••••• 60 9.7 The Make Command ••••••••••••••••••••••••••••••••••••••••• 62 9.8 nroff/troff •••••••••••••••••••••••••••••••••••••••••••••• 64 9.9 awk •••••••••••••••••••••••••••••••••••••••••••••••••••••• 67 9.10 SCCS ••••••••••••••••••••••••••••••••••••••••••••••••••••• 67 9.11 Debuggers •••••••••••••••••••••••••••••••••••••••••••••••• 67 10. ADMINISTRATIVE FUNCTIONS •••••••••••••••••••••••••••••••••••••••• 69 10.1 Adding New Users - Removing Old Users •••••••••••••••••••• 69 10.2 Managing Processes ••••••••••••••••••••••••• : ••••••••••••• 72 10.3 Setting /etc/motd •••••••••••••••••••••••••••••••••••••••• 72 - ii - Monitoring File System Usage ••••••••••••••••••••••••••••• 72 10.5 Garbage Collection ••••••••••••••••••••••••••••••••••••••• 73 10.6 Examining Log Files •••••••••••••••••••••••••••••••••••••• 74 10.7 Setting the Date and TZ •••••••••••••••••••••••••••••••••• 74 10.8 Checking the Nodename •••••••••••••••••••••••••••••••••••• 76 10.9 Running Vchk ••••••••••••••••••••••••••••••••••••••••••••• 76 10.10 Init ••••••••••••••••••••••••••••••••••••••••••••••••••••• 77 Adjusting /etc/inittab and letc/rc._ •• _••• _•••• ___ ._~. __ = 78 10.12 Mail Aliases (System V.O) •••••••••••••••••••••••••••••••• 78 10.13 System Security •••••••••••••••••••••••••••••••••••••••••• 79 10.14 System Backups ••••••••••••••••••••••••••••••••••••••••••• 80 10.15 Other Things to Watch •••••••••••••••••••••••••••••••••••• 80 11. USING FLOPPY DISKETTES AND TAPE ••••••••••••••••••••••••••••••••• 81 11.1 Floppy Disk •••••••••••••••••••••••••••••••••••••••••••••• 81 11.2 Streamer Tape •••••••••••••••••••••••••••••••••••••••••••• 85 11.3 Reel-to-Reel Tape •••••••••••••••••••••••••••••••••••••••• 89 11.4 Media Interchange •••••••••••••••••••••••••••••••••••••••• 90 11.5 Backups via Ethernet ••••••••••••••••••••••••••••••••••••• 91 11.6 Method Comparison •••••••••••••••••••••••••••••••••••••••• 91 12. REBUILDING THE UNIX SySTEM •••••••••••••••••••••••••••••••••••••• 92 12.1 Floppy or Tape Rebuilding •••••••••••••••••••••••••••••••• 94 12.2 Creating Boot and Rebuild Diskettes •••••••••••••••••••••• 98 12.3 Creating Streamer Tape Dumps ••••••••••••••••••••••••••••• 99 12.4 Writing the Standalone Boot to Winchester •••••••••••••••• 100 12.5 Bad Block Checking ••••••••••••••••••••••••••••••••••••••• 100 12.6 Manual Disk Format/Mkfs •••••••••••••••••••••••••••••••••• 100 12.7 Changing the Swap Space Size ••••••••••••••••••••••••••••• 101 12.8 File System Check, fsck •••••••••••••••••••••••••••••••••• 102 12.9 Creative Use of the Rebuild Diskette ••••••••••••••••••••• 103 12.10 Winchester Partitioning •••••••••••••••••••••••••••••••••• 104 12.11 Multiple Winchester Drives ••••••••••••••••••••••••••••••• 106 13. ACCESSING I/O DEVICES (DEVICE DRIVERS) •••••••••••••••••••••••••• 107 13.1 phys(2) System Call •••••••••••••••••••••••••••••••••••••• 107 13.2 /dev/mem and /dev/kmem ••••••••••••••••••••••••••••••••••• 109 13.3 Device Drivers - Reconfiguration Rights •••••••••••••••••• 110 13.4 Installing a New Device Driver ••••••••••••••••••••••••••• 113 13.5 Removing a Device Driver ••••••••••••••••••••••••••••••••• 115 13.6 Hints for Writing a New Device Driver •••••••••••••••••••• 116 13.7 Common Device Driver Problems •••••••••••••••••••••••••••• 117 13.8 Kernel Routines and Macros ••••••••••••••••••••••••••••••• 117 13.9 Kernel Tables •••••••••••••••••••••••••••••••••••••••••••• 123 14. I/O ERROR CODES ••••••••••••••••••••••••••••••••••••••••••••••••• 124 14.1 Winchester Errors •••••••••••••••••••••••••••••••••••••••• 124 14.2 Reel-to-Reel Tape Errors (MI0) ••••••••••••••••••••••••••• 125