RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C) ------------------------------------------------------------------------------- restorebsd PURPOSE Reads tapes dumped with the dumpbsd command. SYNTAX +----------+ +------------------+ +--------+ /etc/restorebsd ---| one of |---| +--------------+ |---| |---| | +------+ | +-| v |-+ ^ +- name -+ | +-| r + |-+ ^| F input_file || +------------+ | R i | || y || | x | || m || +------+ || h || || b || || c || || d || || s || |+--------------+| +----------------+ DESCRIPTION Note: The restorebsd command is not used to port information between AIX and BSD systems. The tar command is used for compatibility with BSD systems. The restorebsd command reads the tape or specified device dumped with the dumpbsd command. Its actions are controlled by the flags described below. Other arguments to the command are file or directory names specifying the files that are to be restored. Unless the h flag is specified, the appearance of a directory name refers to the files and (recursively) subdirectories of that directory. FLAGS You can specify one of the following flags to describe the function: r The tape is read and loaded into the current directory. This should not be done lightly; the r key should only be used to restore a complete dump tape onto a clear file system or to restore an incremental dump tape after a full level zero restore. Thus Processed November 8, 1990 RESTOREBSD(8,C) 1 RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C) /etc/mkfs /dev/rhd? /etc/mount /dev/hd? /mnt cd /mnt restorebsd r is a typical sequence to restore a complete dump. Another restorebsd can be done to get an incremental dump in on top of this. Note that restorebsd leaves a file restoresymtable in the root directory to pass information between incremental restore passes. This file should be removed when the last incremental tape has been restored. R The restorebsd command requests a particular tape of a multi-volume set on which to restart a full restore (see the r key above). This allows restorebsd to be interrupted and then restarted. x The named files are extracted from the tape. If the named file matches a directory whose contents had been written onto the tape, and the h key is not specified, the directory is recursively extracted. The owner, modification time, and mode are restored (if possible). If no file argument is given, then the root directory is extracted, which results in the entire content of the tape being extracted, unless the h key has been specified. t The names of the specified files are listed if they occur on the tape. If no file argument is given, then the root directory is listed, which results in the entire content of the tape being listed, unless the h key has been specified. The t key replaces the function of the old dumpdir program. i This mode allows interactive restoration of files from a dump tape. After reading in the directory information from the tape, restorebsd provides a shell like interface that allows the user to move around the directory tree selecting files to be extracted. The available commands are given below; for those commands that require an argument, the default is the current directory. ls [arg] List the current or specified directory. Entries that are directories are appended with a "/". Entries that have been marked for extraction are prepended with a "*". If the verbose key is set the inode number of each entry is also listed. cd arg Change the current working directory to the specified argument. pwd Print the full path name of the current working directory. add [arg] The current directory or specified argument is added to the list of files to be extracted. If a directory is specified, then it and all its descendents are added to the extraction list (unless the h key is specified on the Processed November 8, 1990 RESTOREBSD(8,C) 2 RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C) command line). Files that are on the extraction list are prepended with a "*" when they are listed by ls. delete [arg] The current directory or specified argument is deleted from the list of files to be extracted. If a directory is specified, then it and all its descendents are deleted from the extraction list (unless the h key is specified on the command line). The most expedient way to extract most of the files from a directory is to add the directory to the extraction list and then delete those files that are not needed. extract All the files that are on the extraction list are extracted from the dump tape. restorebsd will ask which volume the user wishes to mount. The fastest way to extract a few files is to start with the last volume, and work towards the first volume. setmodes All the directories that have been added to the extraction list have their owner, modes, and times set; nothing is extracted from the tape. This is useful for cleaning up after a restore has been prematurely aborted. verbose The sense of the v key is toggled. When set, the verbose key causes the ls command to list the inode numbers of all entries. It also causes restorebsd to print out information about each file as it is extracted. help List a summary of the available commands. quit Restore immediately exits, even if the extraction list is not empty. D Toggles debugging mode. x Immediate quit (same as quit command). The following flags can be used to modify the function of restorebsd: v Normally restorebsd does its work silently. The v (verbose) key causes it to type the name of each file it treats preceded by its file type. f The next argument to restorebsd is used as the name of the archive device instead of /dev/rmt?. If the name of the file is "-", restorebsd reads from standard input. Thus, dumpbsd and restorebsd can be used in a pipeline to dump and restore a file system with the command /etc/dumpbsd 0f - /usr | (cd /mnt; /etc/restorebsd xf -) Processed November 8, 1990 RESTOREBSD(8,C) 3 RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C) F The next argument to restorebsd is used as the name of a file from which interactive input is read. Normally, standard input (or the controlling terminal if the f key specifies standard input) is read. This flag allows the interactive mode of restorebsd to be driven from a command file when the archive file is standard input. The interactive interface, the prompt for next volume number, and the prompt to set the access mode for "." are affected. Error recovery interaction and verifying operator readiness are not affected. For example, if the file inputfile contains add delete foo add foo/bar extract 1 yes quit then the command /etc/restorebsd iF inputfile will use the interactive mode to automatically mark everything for extraction, unmark the directory foo, mark foo/bar, extract the marked files, specify volume 1, set the access mode for ".", and quit. The easiest way to determine the commands needed is to do the restore by hand once, and write down everything that you type. y The restorebsd command will not ask whether it should abort the restore if gets a tape error. It will always try to skip over the bad tape block(s) and continue as best it can. m The restorebsd command will extract by inode numbers rather than by file name. This is useful if only a few files are being extracted, and one wants to avoid regenerating the complete path name to the file. h The restorebsd command extracts the actual directory, rather than the files that it references. This prevents hierarchical restoration of complete subtrees from the tape. b The next argument to restorebsd is used as the block size of the tape (in kilobytes). If this key is not present, restorebsd tries to determine the block size dynamically. c Convert an old style dump tape (pre 4.2BSD file system). d Debug mode. The restorebsd command will perform many internal consistency checks and print out the debugging information. s The next argument to restorebsd is used as the number (1 origin) of the dump file to restore. Allows more than one dump file on a tape. Processed November 8, 1990 RESTOREBSD(8,C) 4 RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C) FILES /dev/rmt? The default tape drive. /tmp/rstdir* File containing directories on the tape. /tmp/rstmode* Owner, mode, and time stamps for directories. ./restoresymtable Information passed between incremental restores. Note: The restorebsd command is not used to port information between AIX and BSD systems. The tar command is used for compatibility with BSD systems. RELATED INFORMATION See the following commands: "backup," "dumpbsd," "mount," "mkfs," "rrestore," and "rdump." Processed November 8, 1990 RESTOREBSD(8,C) 5