ccdconfig(8) [netbsd man page]

CCDCONFIG(8)						    BSD System Manager's Manual 					      CCDCONFIG(8)

NAME

     ccdconfig -- configuration utility for the concatenated disk driver

SYNOPSIS

     ccdconfig [-cv] ccd ileave [flags] dev [...]
     ccdconfig -C [-v] [-f config_file]
     ccdconfig -u [-v] ccd [...]
     ccdconfig -U [-v] [-f config_file]
     ccdconfig -g [-M core] [-N system] [ccd [...]]

DESCRIPTION

     ccdconfig is used to dynamically configure and unconfigure concatenated disk devices, or ccds.  For more information about the ccd, see
     ccd(4).

     The options are as follows:

     -c      Configure a ccd.  This is the default behavior of ccdconfig.

     -C      Configure all ccd devices listed in the ccd configuration file.

     -f config_file
	     When configuring or unconfiguring all devices, read the file config_file instead of the default /etc/ccd.conf.

     -g      Dump the current ccd configuration in a format suitable for use as the ccd configuration file.  If no arguments are specified, every
	     configured ccd is dumped.	Otherwise, the configuration of each listed ccd is dumped.

     -M core
	     Extract values associated with the name list from core instead of the default /dev/mem.

     -N system
	     Extract the name list from system instead of the default /netbsd.

     -u      Unconfigure a ccd.

     -U      Unconfigure all ccd devices listed the ccd configuration file.

     -v      Causes ccdconfig to be verbose.

     A ccd is described on the command line and in the ccd configuration file by the name of the ccd, the interleave factor, the ccd configuration
     flags, and a list of one or more devices.	The flags may be represented as a decimal number, a hexadecimal number, a comma-separated list of
     strings, or the word ``none''.  The flags are as follows:

	   Symbolic	    Numeric  Comment
	   CCDF_UNIFORM     0x02     Use uniform interleave. The size of all components is clamped to that of the smallest component.
	   CCDF_NOLABEL     0x04     Ignore raw disklabel. Useful when creating a new ccd.

   /etc/ccd.conf
     The file /etc/ccd.conf is used to configure ccdconfig if -C or -U is used.  Each line of the configuration file contains arguments as per the
     -c argument: ccd ileave [flags] dev [...]

     A '#' is a comment, and everything to end of line is ignored.  A '' at the end of a line indicates that the next line should be concatenated
     with the current.	A '' preceding any character (other than the end of line) prevents that character's special meaning from taking effect.

     See EXAMPLES for an example of /etc/ccd.conf.

FILES

     /etc/ccd.conf - default ccd configuration file.

EXAMPLES

     The following command, executed from the command line, would configure ccd0 with 4 components (/dev/sd2e, /dev/sd3e, /dev/sd4e, /dev/sd5e),
     and an interleave factor of 32 blocks.

	   # ccdconfig ccd0 32 0 /dev/sd2e /dev/sd3e /dev/sd4e /dev/sd5e

     An example /etc/ccd.conf:

	   #
	   # /etc/ccd.conf
	   # Configuration file for concatenated disk devices
	   #

	   # ccd	   ileave  flags   component devices
	   ccd0 	   16	   none    /dev/sd2e /dev/sd3e

SEE ALSO

     ccd(4), ccd.conf(5), rc(8)

HISTORY

     The ccdconfig command first appeared in NetBSD 1.1.

BSD
								 October 17, 2003							       BSD

Check Out this Related Man Page

CCD(4)							   BSD Kernel Interfaces Manual 						    CCD(4)

NAME

     ccd -- Concatenated disk driver

SYNOPSIS

     pseudo-device ccd [count]

DESCRIPTION

     The ccd driver provides the capability of combining one or more disks/partitions into one virtual disk.

     This document assumes that you're familiar with how to generate kernels, how to properly configure disks and pseudo-devices in a kernel con-
     figuration file, and how to partition disks.

     Note that the 'raw' partitions of the disks must not be combined.	Each component partition should be offset at least one cylinder from the
     beginning of the component disk.  This avoids potential conflicts between the component disk's disklabel and the ccd's disklabel.	The kernel
     will only allow component partitions of type FS_CCD.  But for now, it allows partition of all types since some port lacks support of an on-
     disk BSD disklabel.  The partition of FS_UNUSED may be rejected because device driver of component disk will refuse it.

     In order to compile in support for the ccd, you must add a line similar to the following to your kernel configuration file:

	   pseudo-device  ccd  4    # concatenated disk devices

     The count argument is how many ccds memory is allocated for at boot time.	In this example, no more than 4 ccds may be configured.

     A ccd may be either serially concatenated or interleaved.	To serially concatenate the partitions, specify the interleave factor of 0.

     If a ccd is interleaved correctly, a ``striping'' effect is achieved, which can increase performance.  Since the interleave factor is
     expressed in units of DEV_BSIZE, one must account for sector sizes other than DEV_BSIZE in order to calculate the correct interleave.  The
     kernel will not allow an interleave factor less than the size of the largest component sector divided by DEV_BSIZE.

     Note that best performance is achieved if all component disks have the same geometry and size.  Optimum striping cannot occur with different
     disk types.

     Also note that the total size of concatenated disk may vary depending on the interleave factor even if the exact same components are concate-
     nated.  And an old on-disk disklabel may be read after interleave factor change.  As a result, the disklabel may contain wrong partition
     geometry and will cause an error when doing I/O near the end of concatenated disk.

     There is a run-time utility that is used for configuring ccds.  See ccdconfig(8) for more information.

WARNINGS

     If just one (or more) of the disks in a non-mirrored ccd fails, the entire file system will be lost.

FILES

     /dev/{,r}ccd*  ccd device special files.

SEE ALSO

     config(1), MAKEDEV(8), ccdconfig(8), fsck(8), mount(8), newfs(8)

HISTORY

     The concatenated disk driver was originally written at the University of Utah.

BSD
								   March 5, 2004							       BSD

Linux and UNIX Man Pages

ccdconfig(8) [netbsd man page]

Check Out this Related Man Page