'\"macro stdmacro
.if n .pH g1a.dcopy @(#)dcopy	40.9 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} dcopy 1M "" "\&"
.if \nX=1 .ds x} dcopy 1M ""
.if \nX=2 .ds x} dcopy 1M "" "\&"
.if \nX=3 .ds x} dcopy "" "" "\&"
.TH \*(x}
.SH NAME
\f4dcopy\f1 (generic) \- copy file systems for optimal access time
.SH SYNOPSIS
\f4dcopy\f1 [\f4\-F\f2 FSType\f1] [\f4\-V\f1] [\f2current_options\f1] [\f4\-o\f1 \f2specific_options\f1]\f2 inputfs outputfs\f1
.SH DESCRIPTION
\f4dcopy\f1
copies file system
.I inputfs
to
.IR outputfs .
.I inputfs
is the device file for the existing file system;
.I outputfs
is the device file to hold the reorganized result.
For the most effective optimization
.I inputfs
should be the raw device and
.I outputfs
should be the block device.
Both
.I inputfs
and
.I outputfs
should be unmounted file systems.
.PP
\f2current_options\f1
are options supported by the \f4s5\f1-specific module of \f4dcopy\f1.
Other FSTypes do not necessarily support these options.
\f2specific_options\f1 indicate suboptions specified in a comma-separated 
list of suboptions and/or keyword-attribute pairs for interpretation by 
the \f2FSType\f1-specific module of the command. 
.PP
The options are:
.TP 10
\f4\-F\f1
Specify the \f2FSType\f1 on which to operate.
The \f2FSType\f1 should 
either be specified here or be determinable from \f4/etc/vfstab\f1
by matching the \f2inputfs\f1 (device) with an entry in the table.
.TP 10
\f4\-V\f1
Echo the complete command line,
but do not execute the command.
The command line is generated by using
the options and arguments provided by the user
and adding to them information
derived from \f4/etc/vfstab\f1.
This option should be used to
verify and validate the command line.
.TP 10
\f4\-o\f1
Specify FSType-specific options.
.SH NOTE
This command may not be supported for all FSTypes.
.SH FILES
.TP 10
\f4/etc/vfstab\f1 	list of default parameters for each file system
.SH SEE ALSO
\f4vfstab\f1(4).
.br
Manual pages for the FSType-specific modules of \f4dcopy\f1.
