| restore.8 (128073) | restore.8 (128175) |
|---|---|
| 1.\" Copyright (c) 1985, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)restore.8 8.4 (Berkeley) 5/1/95 | 1.\" Copyright (c) 1985, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)restore.8 8.4 (Berkeley) 5/1/95 |
| 29.\" $FreeBSD: head/sbin/restore/restore.8 128073 2004-04-09 19:58:40Z markm $ | 29.\" $FreeBSD: head/sbin/restore/restore.8 128175 2004-04-13 02:58:06Z green $ |
| 30.\" 31.Dd May 1, 1995 32.Dt RESTORE 8 33.Os 34.Sh NAME 35.Nm restore , 36.Nm rrestore 37.Nd "restore files or file systems from backups made with dump" 38.Sh SYNOPSIS 39.Nm 40.Fl i 41.Op Fl cdhmNuvy 42.Op Fl b Ar blocksize | 30.\" 31.Dd May 1, 1995 32.Dt RESTORE 8 33.Os 34.Sh NAME 35.Nm restore , 36.Nm rrestore 37.Nd "restore files or file systems from backups made with dump" 38.Sh SYNOPSIS 39.Nm 40.Fl i 41.Op Fl cdhmNuvy 42.Op Fl b Ar blocksize |
| 43.Op Fl f Ar file | 43.Op Fl f Ar file | Fl P Ar pipecommand |
| 44.Op Fl s Ar fileno 45.Nm 46.Fl R 47.Op Fl cdNuvy 48.Op Fl b Ar blocksize | 44.Op Fl s Ar fileno 45.Nm 46.Fl R 47.Op Fl cdNuvy 48.Op Fl b Ar blocksize |
| 49.Op Fl f Ar file | 49.Op Fl f Ar file | Fl P Ar pipecommand |
| 50.Op Fl s Ar fileno 51.Nm 52.Fl r 53.Op Fl cdNuvy 54.Op Fl b Ar blocksize | 50.Op Fl s Ar fileno 51.Nm 52.Fl r 53.Op Fl cdNuvy 54.Op Fl b Ar blocksize |
| 55.Op Fl f Ar file | 55.Op Fl f Ar file | Fl P Ar pipecommand |
| 56.Op Fl s Ar fileno 57.Nm 58.Fl t 59.Op Fl cdhNuvy 60.Op Fl b Ar blocksize | 56.Op Fl s Ar fileno 57.Nm 58.Fl t 59.Op Fl cdhNuvy 60.Op Fl b Ar blocksize |
| 61.Op Fl f Ar file | 61.Op Fl f Ar file | Fl P Ar pipecommand |
| 62.Op Fl s Ar fileno 63.Op Ar 64.Nm 65.Fl x 66.Op Fl cdhmNuvy 67.Op Fl b Ar blocksize | 62.Op Fl s Ar fileno 63.Op Ar 64.Nm 65.Fl x 66.Op Fl cdhmNuvy 67.Op Fl b Ar blocksize |
| 68.Op Fl f Ar file | 68.Op Fl f Ar file | Fl P Ar pipecommand |
| 69.Op Fl s Ar fileno 70.Op Ar 71.Pp 72.Nm rrestore 73is an alternate name for 74.Nm . 75.Pp 76.in \" XXX --- 11 unchanged lines hidden (view full) --- 88Single files and 89directory subtrees may be restored from full or partial 90backups. 91The 92.Nm 93utility works across a network; 94to do this see the 95.Fl f | 69.Op Fl s Ar fileno 70.Op Ar 71.Pp 72.Nm rrestore 73is an alternate name for 74.Nm . 75.Pp 76.in \" XXX --- 11 unchanged lines hidden (view full) --- 88Single files and 89directory subtrees may be restored from full or partial 90backups. 91The 92.Nm 93utility works across a network; 94to do this see the 95.Fl f |
| 96flag described below. | 96and 97.Fl P 98flags described below. |
| 97Other arguments to the command are file or directory 98names specifying the files that are to be restored. 99Unless the 100.Fl h 101flag is specified (see below), 102the appearance of a directory name refers to 103the files and (recursively) subdirectories of that directory. 104.Pp --- 194 unchanged lines hidden (view full) --- 299(the standard input). 300If the name of the file is of the form 301.Dq host:file , 302or 303.Dq user@host:file , 304.Nm 305reads from the named file on the remote host using 306.Xr rmt 8 . | 99Other arguments to the command are file or directory 100names specifying the files that are to be restored. 101Unless the 102.Fl h 103flag is specified (see below), 104the appearance of a directory name refers to 105the files and (recursively) subdirectories of that directory. 106.Pp --- 194 unchanged lines hidden (view full) --- 301(the standard input). 302If the name of the file is of the form 303.Dq host:file , 304or 305.Dq user@host:file , 306.Nm 307reads from the named file on the remote host using 308.Xr rmt 8 . |
| 309.It Fl P Ar pipecommand 310Use 311.Xr popen 3 312to execute the 313.Xr sh 1 314script string defined by 315.Ar pipecommand 316as the input for every volume in the backup. 317This child pipeline's 318.Dv stdout 319.Pa ( /dev/fd/1 ) 320is redirected to the 321.Nm 322input stream, and the environment variable 323.Ev RESTORE_VOLUME 324is set to the current volume number being read. 325The 326.Ar pipecommand 327script is started each time a volume is loaded, as if it were a tape drive. |
|
| 307.It Fl h 308Extract the actual directory, 309rather than the files that it references. 310This prevents hierarchical restoration of complete subtrees 311from the dump. 312.It Fl m 313Extract by inode numbers rather than by file name. 314This is useful if only a few files are being extracted, --- 170 unchanged lines hidden --- | 328.It Fl h 329Extract the actual directory, 330rather than the files that it references. 331This prevents hierarchical restoration of complete subtrees 332from the dump. 333.It Fl m 334Extract by inode numbers rather than by file name. 335This is useful if only a few files are being extracted, --- 170 unchanged lines hidden --- |