6324 Add an `ndp' tool for manipulating the neighbors table
[illumos-gate.git] / usr / src / man / man1m / prtvtoc.1m
blob4f883420c1935d579fe37dd82a42584ff094b9a3
1 '\" te
2 .\"  Copyright 1989 AT&T All Rights Reserved. Copyright (c) 2002, 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 PRTVTOC 1M "Jul 25, 2002"
7 .SH NAME
8 prtvtoc \- report information about a disk geometry and partitioning
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBprtvtoc\fR [\fB-fhs\fR] [\fB-t\fR \fIvfstab\fR] [\fB-m\fR \fImnttab\fR] \fIdevice\fR
13 .fi
15 .SH DESCRIPTION
16 .sp
17 .LP
18 The \fBprtvtoc\fR command allows the contents of the label to be viewed. The
19 command can be used only by the super-user.
20 .sp
21 .LP
22 The \fIdevice\fR name can be the file name of a raw device in the form of
23 \fB/dev/rdsk/c?t?d?s2\fR or can be the file name of a block device in the form
24 of \fB/dev/dsk/c?t?d?s2\fR.
25 .SH OPTIONS
26 .sp
27 .LP
28 The following options are supported:
29 .sp
30 .ne 2
31 .na
32 \fB\fB-f\fR\fR
33 .ad
34 .RS 13n
35 Report on the disk free space, including the starting block address of the free
36 space, number of blocks, and unused partitions.
37 .RE
39 .sp
40 .ne 2
41 .na
42 \fB\fB-h\fR\fR
43 .ad
44 .RS 13n
45 Omit the headers from the normal output.
46 .RE
48 .sp
49 .ne 2
50 .na
51 \fB\fB-m\fR\fI mnttab\fR\fR
52 .ad
53 .RS 13n
54 Use \fImnttab\fR as the list of mounted filesystems, in place of
55 \fB/etc/mnttab\fR.
56 .RE
58 .sp
59 .ne 2
60 .na
61 \fB\fB-s\fR\fR
62 .ad
63 .RS 13n
64 Omit all headers but the column header from the normal output.
65 .RE
67 .sp
68 .ne 2
69 .na
70 \fB\fB-t\fR\fI vfstab\fR\fR
71 .ad
72 .RS 13n
73 Use \fIvfstab\fR as the list of filesystem defaults, in place of
74 \fB/etc/vfstab\fR.
75 .RE
77 .SH EXAMPLES
78 .LP
79 \fBExample 1 \fRUsing the \fBprtvtoc\fR Command
80 .sp
81 .LP
82 The following example uses the \fBprtvtoc\fR command on a 424-megabyte hard
83 disk:
85 .sp
86 .in +2
87 .nf
88 example# prtvtoc /dev/rdsk/c0t3d0s2
89 * /dev/rdsk/c0t3d0s2 partition map
91 * Dimension:
92 *     512 bytes/sector
93 *      80 sectors/track
94 *       9 tracks/cylinder
95 *     720 sectors/cylinder
96 *    2500 cylinders
97 *    1151 accessible cylinders
99 * Flags:
100 *   1: unmountable
101 *  10: read-only
102 * *                           First    Sector   Last
103 * Partition   Tag   Flags   Sector   Count    Sector   Mount Directory
104      0         2     00          0    76320    76319   /
105      1         3     01      76320   132480   208799
106      2         5     00          0   828720   828719
107      5         6     00     208800   131760   340559   /opt
108      6         4     00     340560   447120   787679   /usr
109      7         8     00     787680    41040   828719   /export/home
110 example#
112 .in -2
117 The data in the \fBTag\fR column above indicates the type of partition, as
118 follows:
124 c c
125 l l .
126 \fIName\fR      \fINumber\fR
127 UNASSIGNED      0x00
128 BOOT    0x01
129 ROOT    0x02
130 SWAP    0x03
131 USR     0x04
132 BACKUP  0x05
133 STAND   0x06
134 VAR     0x07
135 HOME    0x08
136 ALTSCTR  0x09
137 CACHE   0x0a
138 RESERVED        0x0b
143 The data in the \fBFlags\fR column above indicates how the partition is to be
144 mounted, as follows:
150 l l
151 l l .
152 \fIName\fR      \fINumber\fR
153 MOUNTABLE, READ AND WRITE       0x00
154 NOT MOUNTABLE   0x01
155 MOUNTABLE, READ ONLY    0x10
159 \fBExample 2 \fRUsing the \fBprtvtoc\fR Command with the \fB-f\fR Option
162 The following example uses the \fBprtvtoc\fR command with the \fB-f\fR option
163 on a 424-megabyte hard disk:
166 .in +2
168 example# prtvtoc \fB-f\fR /dev/rdsk/c0t3d0s2
169 FREE_START=0 FREE_SIZE=0 FREE_COUNT=0 FREE_PART=34
171 .in -2
175 \fBExample 3 \fRUsing the \fBprtvtoc\fR Command on a Disk Over One Terabyte
178 The following example uses uses the \fBprtvtoc\fR command on a disk over one
179 terabyte:.
182 .in +2
184 example# prtvtoc /dev/rdsk/c1t1d0s2
185 * /dev/rdsk/c1t1d0s2 partition map
187 * Dimensions:
188 *     512 bytes/sector
189 * 3187630080 sectors
190 * 3187630013 accessible sectors
192 * Flags:
193 *   1: unmountable
194 *  10: read-only
196 *                          First     Sector    Last
197 * Partition  Tag  Flags    Sector     Count    Sector  Mount Directory
198 0      2    00         34    262144    262177
199 1      3    01     262178    262144    524321
200 6      4    00     524322 3187089340 3187613661
201 8     11    00  3187613662     16384 318763004
203 .in -2
206 .SH SEE ALSO
209 \fBdevinfo\fR(1M), \fBfmthard\fR(1M), \fBformat\fR(1M), \fBmount\fR(1M),
210 \fBattributes\fR(5)
211 .SH WARNINGS
214 The \fBmount\fR command does not check the "not mountable" bit.