RESTORE.TAPE(8) —

NAME

restore.tape, restore.net − install system from tape or over network

SYNOPSIS

restore.tape [options] partition ...
restore.net [options] partition ...

DESCRIPTION

Note: These commands are only on the installation miniroot.

Restore.tape installs a system from distribution tapes. Restore.net installs a system from one host to another over a local area network. Both use restore(8) and read a dump(8) archive, either from the streaming tape or from dump(8) executed on a remote host via rsh(1C).

Restore.tape and restore.net are used from the miniroot diskette. Normally, they are not used directly, although they can be used directly to perform non-standard installations.

The following options are available to both restore.tape and restore.net:

−T hdxy
Mount the writable /tmp directory on the y partition of the hdx disk. If y is omitted, it defaults to b. If the −T option is omitted, hd0b is used.

−fn
The file /etc/fstab.hd.n is copied into /etc/fstab on the root partition after it is installed. N may be 1 or 3. The original /etc/fstab is copied into /etc/fstab.old. Without the −fn option, /etc/fstab is unchanged. These options work only if the root partition is installed as hd??=root or as hd?=root/user.

−k kernel
Install /kernel into /vmunix. For example, −k vmunix.special will install /vmunix.special into /vmunix after the root partition has been installed. This option works only if the root partition is installed as hd??=root or as hd?=root/user.

−m mask
Specify a mask which prevents certain parts of the system from being installed. Currently available masks are:

nodoc
Prevents installation of documentation source in /usr/doc.

nofont
Prevents installation of the 3812 font libraries in /usr/lib/font.

nokernel
Prevents installation of kernel source in /usr/sys, except for header files normally available via symbolic links in /usr/include.

nolearn
Prevents installation of the learn(1) data base library in /usr/lib/learn.

noman
Prevents installation of on-line man pages in /usr/man.

nonotes
Prevents installation of notesfiles in /usr/spool/notes.

nosupport
Prevents installation of site support tools in /usr/sys/support.

nouser
Prevents installation of the contents of the user partition when installing the root partition. This is useful for installing just the root partition from the ROOT/USER tape. See the EXAMPLES section below.

−newfs string
Pass string to newfs on the command line. By default, the string “−m 5” is passed to newfs.

−q
Quiet. Reduces the volume of output to the screen.

−x
The command newfs(8) is not used to create new filesystems. See the BUGS section below.

The following option is available only to restore.tape:

−bn
Use n tbuffer(8R) buffers to buffer streaming tape. If n is omitted, or if the −bn option is not used, 4 buffers are used. If n is 0, tbuffer(8R) is not used.

The following options are available only to restore.net:

−s sourcehost
Use sourcehost as the remote host for installation. Sourcehost may be either a hostname (ie, “master”) or an internet address (ie, “46.0.0.1”), and defaults to master. Sourcehost must have an entry for desthost in its /etc/hosts, /etc/hosts.equiv, and /.rhosts files.

−d desthost
Configure network interface as desthost. Desthost may be either a hostname (ie, “slave”) or an internet address (ie, “46.0.0.2”), and defaults to slave.

−un
−lan

Specify preference for un0 (ethernet) or lan0 (token ring) network interface. By default, restore.net attempts to configure un0, then lan0. If the −lan option is specified, lan0 is tried first, then un0.

−ifconfig string
Pass string to ifconfig on the command line. By default, the null string is passed to ifconfig. This allows users to install over networks using protocols other than the default. See ifconfig(8) if your site does not use the default protocols.

The allowed partitions for both restore.tape and restore.netare:

disk
Install disk from tape, or from disk on master host. Disk may be hd[0-2][a-h] or sc[01][a-h].

disk=name
Install disk fromtape, or from the named file system on master host. Name may be root, user, or source. Note that mastking (−m mast) is done based on name, and will NOT be done unless this format is used.

The allowed partitions for restore.tape only are:

disk
disk=name

For tape installation, disk may also be hd[0-2], as before. Name must be root/user. This is used for installing distribution root/user tapes.

The allowed partitions for restore.net only are:

disk1=disk2
The contents of disk2 on the master host are installed on disk1 on this host. Note that masking is not done!

disk=filesystem
Filesystem may be any mountpoint listed in /etc/fstab on the master host. It does the same thing as the above format would if disk2 were the partition mounted on the mountpoint filesystem. Note that masking is not done!

Note that the following partition formats are no longer allowed:

disk:name
Use disk=name instead.

disk=disk:name
Use disk=name or disk1=disk2 instead.

EXAMPLES

Install only the root partition from the ROOT/USER tape:

restore.tape -m nouser hd0a=root

Install all distribution tapes normally:

restore.tape -f3 hd0=root/user hd1g=source

Install the hd2c partition from the hd2g partition on myhost:

restore.tape -s myhost hd2c=hd2g

BUGS

Using the −x option to prevent the use of newfs(8) is restricted in overlaying a new system onto local additions, because restore(8) cannot create new hard links to new files, when the old hard links to the old files still exist. Symbolic links are affected the same way, although usually they are not as critical.

The character “=” is not allowed in name (disk=name) or file system (disk=filesystem).