usr/src/man/man1m/volcopy_ufs.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T, Copyright (c) 2003, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH VOLCOPY_UFS 1M "Apr 15, 2003"
   7 .SH NAME
   8 volcopy_ufs \- make an image copy of a ufs file system
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBvolcopy\fR [\fB-F\fR ufs] [\fIgeneric_options\fR] \fIfsname\fR \fIsrcdevice\fR \fIvolname1\fR \fIdestdevice\fR \fIvolname2\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBvolcopy\fR makes a literal copy of the \fBufs\fR file system using a
  19 blocksize matched to the device.
  20 .SH OPTIONS
  21 .sp
  22 .LP
  23 The following option is supported:
  24 .sp
  25 .ne 2
  26 .na
  27 \fB\fIgeneric_options\fR\fR
  28 .ad
  29 .RS 19n
  30 options supported by the generic  \fBvolcopy\fR command. See
  31 \fBvolcopy\fR(1M).
  32 .RE
  33
  34 .SH OPERANDS
  35 .sp
  36 .LP
  37 The following operands are supported:
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fIfsname\fR\fR
  42 .ad
  43 .RS 27n
  44 represents the mount point (for example, \fBroot\fR, \fBu1\fR, etc.) of the
  45 file system being copied.
  46 .RE
  47
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fIsrcdevice\fR or \fIdestdevice\fR\fR
  52 .ad
  53 .RS 27n
  54 the disk partition specified using the raw device (for example,
  55 \fB/dev/rdsk/cld0s8\fR, \fB/dev/rdsk/cld1s8\fR, etc.).
  56 .RE
  57
  58 .sp
  59 .ne 2
  60 .na
  61 \fB\fIsrcdevice\fR and \fIvolname1\fR\fR
  62 .ad
  63 .RS 27n
  64 the device and physical volume from which the copy of the file system is being
  65 extracted.
  66 .RE
  67
  68 .sp
  69 .ne 2
  70 .na
  71 \fB\fIdestdevice\fR and \fIvolname2\fR\fR
  72 .ad
  73 .RS 27n
  74 the target device and physical volume.
  75 .RE
  76
  77 .sp
  78 .LP
  79 \fIfsname\fR and \fIvolname\fR are limited to six or fewer characters and
  80 recorded in the superblock. \fIvolname\fR may be `\fB\(mi\fR\&' to use the
  81 existing volume name.
  82 .SH EXIT STATUS
  83 .sp
  84 .LP
  85 The following exit values are returned:
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fB0\fR\fR
  90 .ad
  91 .RS 12n
  92 Successful file system copy.
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fBnon-zero\fR
  99 .ad
 100 .RS 12n
 101 An error has occurred.
 102 .RE
 103
 104 .SH FILES
 105 .sp
 106 .ne 2
 107 .na
 108 \fB\fB/var/adm/filesave.log\fR\fR
 109 .ad
 110 .RS 25n
 111 a record of file systems/volumes copied
 112 .RE
 113
 114 .SH SEE ALSO
 115 .sp
 116 .LP
 117 \fBcpio\fR(1), \fBdd\fR(1M), \fBlabelit\fR(1M), \fBvolcopy\fR(1M),
 118 \fBattributes\fR(5), \fBufs\fR(7FS)
 119 .SH NOTES
 120 .sp
 121 .LP
 122 \fBvolcopy\fR does not support copying to tape devices. Use \fBdd\fR(1M) for
 123 copying to and from tape devices.