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

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1997 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 1M "Mar 20, 1995"
   7 .SH NAME
   8 volcopy \- make an image copy of file system
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBvolcopy\fR [\fB-F\fR \fIFSType\fR] [\fB-V\fR] [\fIgeneric_options\fR]
  13      [\fB-o\fR \fIFSType-specific_options\fR] \fIoperands\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBvolcopy\fR makes a literal copy of the file system. This command may not be
  20 supported for all \fIFSTypes\fR.
  21 .SH OPTIONS
  22 .sp
  23 .LP
  24 The following options are supported:
  25 .sp
  26 .ne 2
  27 .na
  28 \fB\fB-F\fR \fIFSType\fR\fR
  29 .ad
  30 .RS 30n
  31 Specify the \fIFSType\fR on which to operate. The \fIFSType\fR should either be
  32 specified here or be determinable from \fB/etc/vfstab\fR by matching the
  33 \fIoperands\fR with an entry in the table. Otherwise, the default file system
  34 type specified in \fB/etc/default/fs\fR will be used.
  35 .RE
  36
  37 .sp
  38 .ne 2
  39 .na
  40 \fB\fB-V\fR\fR
  41 .ad
  42 .RS 30n
  43 Echo the complete command line, but do not execute the command. The command
  44 line is generated by using the options and arguments provided by the user and
  45 adding to them information derived from \fB/etc/vfstab\fR. This option should
  46 be used to verify and validate the command line.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fIgeneric_options\fR\fR
  53 .ad
  54 .RS 30n
  55 Options that are commonly supported by most \fIFSType\fR-specific command
  56 modules.  The following options are available:
  57 .sp
  58 .ne 2
  59 .na
  60 \fB\fB-a\fR\fR
  61 .ad
  62 .RS 6n
  63 Require the operator to respond "yes" or "no" instead of simply waiting ten
  64 seconds before the copy is made.
  65 .RE
  66
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fB-s\fR\fR
  71 .ad
  72 .RS 6n
  73 (Default) Invoke the DEL if wrong verification sequence.
  74 .RE
  75
  76 .RE
  77
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fB-o\fR \fIFSType-specific_options\fR\fR
  82 .ad
  83 .RS 30n
  84 Specify \fIFSType\fR-specific options in a comma separated (without spaces)
  85 list of suboptions and keyword-attribute pairs for interpretation by the
  86 \fIFSType\fR-specific module of the command.
  87 .RE
  88
  89 .SH OPERANDS
  90 .sp
  91 .LP
  92 The following operands are supported:
  93 .sp
  94 .ne 2
  95 .na
  96 \fB\fIoperands\fR\fR
  97 .ad
  98 .RS 12n
  99 generally include the device and volume names and are file system specific. A
 100 detailed description of the \fIoperands\fR can be found on the
 101 \fIFSType\fR-specific man pages of \fBvolcopy\fR.
 102 .RE
 103
 104 .SH EXIT STATUS
 105 .sp
 106 .LP
 107 The following exit values are returned:
 108 .sp
 109 .ne 2
 110 .na
 111 \fB\fB0\fR\fR
 112 .ad
 113 .RS 5n
 114 Successful file system copy
 115 .RE
 116
 117 .sp
 118 .ne 2
 119 .na
 120 \fB\fB1\fR\fR
 121 .ad
 122 .RS 5n
 123 An error has occurred.
 124 .RE
 125
 126 .SH FILES
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fB/etc/vfstab\fR\fR
 131 .ad
 132 .RS 19n
 133 list of default parameters for each file system
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fB/etc/default/fs\fR\fR
 140 .ad
 141 .RS 19n
 142 default local file system type. Default values can be set for the following
 143 flags in \fB/etc/default/fs\fR. For example: \fBLOCAL=ufs.\fR
 144 .sp
 145 .ne 2
 146 .na
 147 \fB\fBLOCAL:\fR\fR
 148 .ad
 149 .RS 10n
 150 The default partition for a command if no \fIFSType\fR is specified.
 151 .RE
 152
 153 .RE
 154
 155 .SH SEE ALSO
 156 .sp
 157 .LP
 158 \fBlabelit\fR(1M), \fBvfstab\fR(4), \fBattributes\fR(5) Manual pages for the
 159 \fIFSType\fR-specific modules of \fBvolcopy\fR.