7712 mandoc -Tlint does always exit with error code 0
[unleashed.git] / usr / src / man / man4 / mddb.cf.4
blob163d45fbd86836d27c65718ad9988cae4dd99844
1 '\" te
2 .\" Copyright (c) 2003, Sun Microsystems, Inc.
3 .\" All Rights Reserved
4 .\" 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.
5 .\" 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.
6 .\" 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]
7 .TH MDDB.CF 4 "Aug 8, 2003"
8 .SH NAME
9 mddb.cf \- metadevice state database replica locations
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fB/etc/lvm/mddb.cf\fR
14 .fi
16 .SH DESCRIPTION
17 .sp
18 .LP
19 The \fB/etc/lvm/mddb.cf\fR file is created when the \fBmetadb\fR(1M) command is
20 invoked. You should never directly edit this file.
21 .sp
22 .LP
23 The file \fB/etc/lvm/mddb.cf\fR is used by the \fBmetainit\fR(1M) command to
24 find the locations of the metadevice state databases replicas. The \fBmetadb\fR
25 command creates the file and updates it each time it is run. Similar
26 information is entered in the \fB/kernel/drv/md.conf\fR file.
27 .sp
28 .LP
29 Each metadevice state database replica has a unique entry in the
30 \fB/etc/lvm/mddb.cf\fR file. Each entry contains the \fIdriver\fR and
31 \fIminor\fR unit numbers associated with the block physical device where a
32 replica is stored. Each entry also contains the block number of the master
33 block, which contains a list of all other blocks in the replica.
34 .sp
35 .LP
36 Entries in the \fB/etc/lvm/mddb.cf\fR file are of the form: \fIdriver_name
37 \|\|minor_t \|\|daddr_t \| \|checksum\fR where \fIdriver_name\fR and
38 \fIminor_t\fR represent the device number of the physical device storing this
39 replica. \fIdaddr_t\fR is the disk block address. \fIchecksum\fR is used to
40 make certain the entry has not been corrupted. A pound sign (#) introduces a
41 comment.
42 .SH EXAMPLES
43 .LP
44 \fBExample 1 \fRSample File
45 .sp
46 .LP
47 The following example shows a \fBmddb.cf\fR file.
49 .sp
50 .in +2
51 .nf
52 #metadevice database location file do not hand edit
53 #driver minor_t daddr_t device id       checksum
54 sd      152     16      id1,sd@SSEAGATE_JDD288110MC9LH/a        -2613
55 .fi
56 .in -2
57 .sp
59 .sp
60 .LP
61 In the example above, the value for \fBdaddr_t\fR indicates that the offset
62 from the start of a given partition is 16 disk blocks from the start of that
63 partition.
65 .SH FILES
66 .sp
67 .ne 2
68 .na
69 \fB\fB/etc/lvm/mddb.cf\fR\fR
70 .ad
71 .RS 23n
73 .RE
75 .sp
76 .ne 2
77 .na
78 \fB\fB/kernel/drv/md.conf\fR\fR
79 .ad
80 .RS 23n
82 .RE
84 .SH SEE ALSO
85 .sp
86 .LP
87 \fBmdmonitord\fR(1M), \fBmetaclear\fR(1M), \fBmetadb\fR(1M),
88 \fBmetadetach\fR(1M), \fBmetahs\fR(1M), \fBmetainit\fR(1M),
89 \fBmetaoffline\fR(1M), \fBmetaonline\fR(1M), \fBmetaparam\fR(1M),
90 \fBmetarecover\fR(1M), \fBmetarename\fR(1M), \fBmetareplace\fR(1M),
91 \fBmetaroot\fR(1M), \fBmetassist\fR(1M), \fBmetaset\fR(1M), \fBmetastat\fR(1M),
92 \fBmetasync\fR(1M), \fBmetattach\fR(1M), \fBmd.cf\fR(4), \fBmd.tab\fR(4),
93 \fBattributes\fR(5), \fBmd\fR(7D)
94 .sp
95 .LP
96 \fISolaris Volume Manager Administration Guide\fR