NAME

sautil − standalone utility package

DESCRIPTION

Sautil is a package of standalone utility programs used in maintaining IBM/4.3. The package contains the following utilities:

Boot is a standalone program used to boot the kernel (vmunix) into memory and start it executing. 

Format is a standalone program used to format and check disks prior to constructing file systems. 

Dump makes a hexadecimal display (or dump) of a specified disk or file.  It can also be used to make changes to a disk (useful for emergency repair of the disk configuration record at sector 1). 

Cat displays an ASCII file on a screen (similar to cat(1) utility). 

Ls displays the contents of a directory (similar to ls(1) utility).  This is useful for cases where the primary /vmunix has been damaged and a backup copy is known to exist somewhere in the filesystem tree.  By repeatedly using ls, one can search the directory tree for a given file. 

Copy makes a copy of all or part of a disk or diskette.  One use of this is to restore an overwritten bad-block table to the start of the disk (starting at block 8) from a backup copy in another filesystem or from a diskette. 

Debug is the debugger (see debug(8)).  It may be used to display memory or access I/O devices. 

Iplsource changes the IPL (Initial Program Load) or boot order in the non-volatile RAM.  This is used to select the order in which devices are checked for a valid boot block.  The default is to first check the diskettes and then the hard disks.  (IBM RT PC only)

Fdisk displays and allows changes to be made to the master boot record partition table.  The table format is dexcrbed under “Fix Disk Information" in the DOS 3.3 Reference.  (IBM 6152 only)

Install loads a miniroot file system image from diskette to the swap partition of the hard disk.  (IBM 6152 only)

Minidisk displays and allows changes to be made to the minidisk directory.  The directory is in VRM compatible format.  It can be used to change the size and location of the hard disk partitions. 

Dosboot allows a program to be booted off a DOS-format diskette.  This allows several standalone utilities to be present on one diskette. 

Installboot creates a bootable DOS partition on the hard disk to allow users, who don’t have DOS, the ability to boot without a floppy.  (IBM6152 only)

Convert is actually a special way of invoking format(8R).  It should be used only when installing the Extended ESDI disk adapter.  (IBM RT PC only)

Input to these utilities may be edited using the standard line editing characters “^H” and “^U”. 

displays and allows changes to be made to the master boot record partition table.  The table format is described under “Fixed Disk Information” in the DOS 3.3 Reference Manual.  (IBM RT PC only)

EXAMPLE

In this example, sautil is loaded from a diskette; it can also be loaded from /boot in the hd(0,0) file system (e.g., hd(0,0)boot).  Boldface indicates user input. 
 

4.3 BSD UNIX Standalone Maintenance Program $Revision: 12.0 $
 ChoiceDescription
 1     boot - boot standalone program or kernel
2     format - format hard disk
3     dump - display disk or diskette (hex)
4     cat - display a file contents (ASCII)
5     ls - print directory of filesystem
6     copy - copy all/part of disk or diskette
7     debugger - display memory, etc.
8     iplsource - set boot order in nvram
9     minidisk - display/change minidisk directory
10    dosboot - boot standalone program or kernel from DOS diskette
11    convert - R70 (“hd70r”) disk to an E70
 
Enter the menu choice number desired, then press
<Enter>
 Choice: 5
 Directory: hd(0,0).
2.
2..
4.profile
768bin
5boot
1163dev
384etc
1152lib
3lost+found
2304mnt
6sys
16tmp
1920usr
11vmunix
Directory: <Enter>

NOTES

Sautil is packaged as the boot(8) program in /boot and on the installation diskette. The sautil menu is not presented unless the boot program exits, which may be caused by typing control-C when input is expected (at the reboot prompt). 

If the utility invokes the exit routine (either as a normal exit or as the result of an error), the message
 
Exit called - Press Enter to return to main menu
 
will be displayed. Pressing the <Enter> key displays the sautil menu. 

SEE ALSO

boot(8), debug(8), format(8R), minidisk(8R),

PRPQs 5799-WZQ/5799-PFF: IBM/4.3  —  Sept 1988