Add sunlabel(8).
This commit is contained in:
wiz
parent
b5c6c1df63
commit
0690e2497a
@ -1,7 +1,7 @@
|
|||||||
# $NetBSD: Makefile,v 1.1 2002/01/10 16:24:41 mrg Exp $
|
# $NetBSD: Makefile,v 1.2 2002/01/15 00:57:27 wiz Exp $
|
||||||
|
|
||||||
PROG= sunlabel
|
PROG= sunlabel
|
||||||
NOMAN= # sunlabel.8
|
MAN= sunlabel.8
|
||||||
|
|
||||||
LDADD+= -ltermcap -lutil
|
LDADD+= -ltermcap -lutil
|
||||||
DPADD+= ${LIBTERMCAP} ${LIBUTIL}
|
DPADD+= ${LIBTERMCAP} ${LIBUTIL}
|
||||||
|
|||||||
246
usr.sbin/sunlabel/sunlabel.8
Normal file
246
usr.sbin/sunlabel/sunlabel.8
Normal file
@ -0,0 +1,246 @@
|
|||||||
|
.\" $NetBSD: sunlabel.8,v 1.1 2002/01/15 00:57:27 wiz Exp $
|
||||||
|
.\"
|
||||||
|
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
|
||||||
|
.\" All rights reserved.
|
||||||
|
.\"
|
||||||
|
.\" This code is derived from software contributed to The NetBSD Foundation
|
||||||
|
.\" by Thomas Klausner.
|
||||||
|
.\"
|
||||||
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
.\" modification, are permitted provided that the following conditions
|
||||||
|
.\" are met:
|
||||||
|
.\" 1. Redistributions of source code must retain the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer.
|
||||||
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer in the
|
||||||
|
.\" documentation and/or other materials provided with the distribution.
|
||||||
|
.\" 3. All advertising materials mentioning features or use of this software
|
||||||
|
.\" must display the following acknowledgement:
|
||||||
|
.\" This product includes software developed by the NetBSD
|
||||||
|
.\" Foundation, Inc. and its contributors.
|
||||||
|
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
|
||||||
|
.\" contributors may be used to endorse or promote products derived
|
||||||
|
.\" from this software without specific prior written permission.
|
||||||
|
.\"
|
||||||
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
||||||
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
||||||
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
||||||
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||||
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||||
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||||
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
.\"
|
||||||
|
.Dd January 12, 2002
|
||||||
|
.Dt SUNLABEL 8
|
||||||
|
.Os
|
||||||
|
.Sh NAME
|
||||||
|
.Nm sunlabel
|
||||||
|
.Nd read or modify a SunOS disk label
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.Nm
|
||||||
|
.Op Fl disk Ar device
|
||||||
|
.Op Fl fixmagic
|
||||||
|
.Op Fl fixsum
|
||||||
|
.Op Fl new
|
||||||
|
.Op Fl q
|
||||||
|
.Ar device
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
.Nm
|
||||||
|
reads or modifies a
|
||||||
|
.Tn Sun disk label on
|
||||||
|
.Ar device .
|
||||||
|
.Nm
|
||||||
|
only reads/writes the first 512 bytes of
|
||||||
|
.Ar device .
|
||||||
|
.Pp
|
||||||
|
The supported options are:
|
||||||
|
.Bl -tag -width "-disk device" -offset indent
|
||||||
|
.It Fl disk Ar device
|
||||||
|
Use
|
||||||
|
.Ar device
|
||||||
|
as target for the operations (in case
|
||||||
|
.Ar device
|
||||||
|
would start with a dash
|
||||||
|
.Pq Sq \&- ) .
|
||||||
|
.It Fl fixmagic
|
||||||
|
Ignore an incorrect magic number in the disk label.
|
||||||
|
.It Fl fixsum
|
||||||
|
Ignore checksum errors when reading the label.
|
||||||
|
.It Fl new
|
||||||
|
Synthesize a new label rather than reading what is there.
|
||||||
|
.It Fl q
|
||||||
|
Quiet mode - don't print unnecessary babble (currently
|
||||||
|
this suppresses the
|
||||||
|
.Dq sunlabel>
|
||||||
|
prompt).
|
||||||
|
.El
|
||||||
|
.Pp
|
||||||
|
Note that
|
||||||
|
.Fl fixmagic
|
||||||
|
is dangerous, especially when combined with
|
||||||
|
.Fl fixsum ,
|
||||||
|
since it will then happily believe whatever garbage it may
|
||||||
|
find in the label. When using these flags, all values should be
|
||||||
|
checked carefully, both those printed by
|
||||||
|
.Ic L
|
||||||
|
and the partition table printed by
|
||||||
|
.Ic P .
|
||||||
|
.Pp
|
||||||
|
.Nm
|
||||||
|
prints a prompt
|
||||||
|
.Dq sunlabel>
|
||||||
|
and expects commands.
|
||||||
|
The following commands are understood:
|
||||||
|
.Bl -tag -width 35n -offset indent -compact
|
||||||
|
.It \&?
|
||||||
|
Show a short help message.
|
||||||
|
.It Ic [abcdefghijklmnop] Ar <cylno> Ar <size>
|
||||||
|
Change partition (see below).
|
||||||
|
.It Ic L
|
||||||
|
Print label, except for the partition table.
|
||||||
|
.It Ic P
|
||||||
|
Print the partition table.
|
||||||
|
.It Ic Q
|
||||||
|
Quit program (error if no write since last change).
|
||||||
|
.It Ic Q!
|
||||||
|
Quit program (unconditionally) [EOF also quits].
|
||||||
|
.It Ic S
|
||||||
|
Set label in the kernel (orthogonal to
|
||||||
|
.Ic W ) .
|
||||||
|
.It Ic V Ar <name> Ar <value>
|
||||||
|
Change a non-partition label value.
|
||||||
|
.It Ic W
|
||||||
|
Write (possibly modified) label out.
|
||||||
|
.El
|
||||||
|
.Pp
|
||||||
|
The
|
||||||
|
.Ic a
|
||||||
|
through
|
||||||
|
.Ic p
|
||||||
|
commands will accept, for the
|
||||||
|
.Ar <size>
|
||||||
|
parameter, the
|
||||||
|
.Ar nnn/nnn/nnn
|
||||||
|
syntax used by
|
||||||
|
.Tn SunOS 4.x
|
||||||
|
.Ic format .
|
||||||
|
(For those not
|
||||||
|
familiar with this syntax,
|
||||||
|
.Ar a/b/c
|
||||||
|
means
|
||||||
|
.Ar a
|
||||||
|
cylinders +
|
||||||
|
.Ar b
|
||||||
|
tracks +
|
||||||
|
.Ar c
|
||||||
|
sectors. For example, if the disk has 16 tracks of 32 sectors,
|
||||||
|
.Ar 3/4/5
|
||||||
|
means (3*16*32)+(4*32)+5=1669. This calculation always uses the
|
||||||
|
.Ar nsect
|
||||||
|
and
|
||||||
|
.Ar ntrack
|
||||||
|
values as printed by the
|
||||||
|
.Ic L
|
||||||
|
command; in particular, if they are zero (which they will initially be
|
||||||
|
if
|
||||||
|
.Fl new
|
||||||
|
is used), this syntax is not very useful. Some additional strings are
|
||||||
|
accepted. For the
|
||||||
|
.Ar <cylno>
|
||||||
|
parameter,
|
||||||
|
.Dq end-X
|
||||||
|
(where
|
||||||
|
.Ar X
|
||||||
|
is a partition letter) indicates that the partition should start with
|
||||||
|
the first free cylinder after partition
|
||||||
|
.Ar X ;
|
||||||
|
.Dq start-X
|
||||||
|
indicates that the partition should start at the same place as
|
||||||
|
partition
|
||||||
|
.Ar X .
|
||||||
|
For the
|
||||||
|
.Ar <size>
|
||||||
|
parameter,
|
||||||
|
.Dq end-X
|
||||||
|
indicates that the partition should end at the same place as partition
|
||||||
|
.Ar X
|
||||||
|
(even if partition
|
||||||
|
.Ar X
|
||||||
|
ends partway through a cylinder);
|
||||||
|
.Dq start-X
|
||||||
|
indicates that the partition should end with the last cylinder before
|
||||||
|
partition
|
||||||
|
.Ar X ;
|
||||||
|
and
|
||||||
|
.Dq size-X
|
||||||
|
means that the partition's size should exactly match partition
|
||||||
|
.Ar X Ns No 's
|
||||||
|
size.
|
||||||
|
.Pp
|
||||||
|
Note that
|
||||||
|
.Nm
|
||||||
|
supports 16 partitions.
|
||||||
|
.Tn SunOS
|
||||||
|
supports only 8.
|
||||||
|
Labels written by
|
||||||
|
.Nm "" ,
|
||||||
|
when partitions
|
||||||
|
.Ar i
|
||||||
|
through
|
||||||
|
.Ar p
|
||||||
|
are all set
|
||||||
|
.Ar offset=0 size=0 ,
|
||||||
|
are identical to
|
||||||
|
.Tn Sun
|
||||||
|
labels. If any of the
|
||||||
|
.Dq extended
|
||||||
|
partitions are nontrivial, information about them is tucked into some
|
||||||
|
otherwise unused space in the
|
||||||
|
.Tn Sun
|
||||||
|
label format.
|
||||||
|
.Pp
|
||||||
|
The
|
||||||
|
.Ic V
|
||||||
|
command changes fields printed by the
|
||||||
|
.Ic L
|
||||||
|
command.
|
||||||
|
For example, if the
|
||||||
|
.Ic L
|
||||||
|
command prints
|
||||||
|
.Bd -literal -offset indent
|
||||||
|
ascii: ST15230N cyl 5657 alt 2 hd 19 sec 78
|
||||||
|
rpm: 0 pcyl: 0 apc: 0 obs1: 0
|
||||||
|
obs2: 0 intrlv: 1 ncyl: 5657 acyl: 0
|
||||||
|
nhead: 19 nsect: 78 obs3: 0 obs4: 0
|
||||||
|
.Ed
|
||||||
|
.Pp
|
||||||
|
then
|
||||||
|
.Ic V Ar ncyl 6204
|
||||||
|
would set the
|
||||||
|
.Ar ncyl
|
||||||
|
value to 6204, or
|
||||||
|
.Ic V
|
||||||
|
.Ar "ascii Seagate ST15230N cyl 5657 hd 19 sec varying"
|
||||||
|
would set the ascii-label string to that string.
|
||||||
|
.Nm
|
||||||
|
performs very few consistency checks on the values you supply, and the
|
||||||
|
ones it does perform never generate errors, only warnings.
|
||||||
|
.Sh AUTHORS
|
||||||
|
.An der Mouse Aq mouse@rodents.montreal.qc.ca
|
||||||
|
.Sh BUGS
|
||||||
|
It may be that the space in the label where the information for the
|
||||||
|
extended partitions is saved is used by
|
||||||
|
.Tn SunOS .
|
||||||
|
.Pp
|
||||||
|
Not very many consistency checks are done on the
|
||||||
|
.Ic V
|
||||||
|
arguments, and those only produce warnings.
|
||||||
|
.Pp
|
||||||
|
.Nx
|
||||||
|
doesn't support 16 partitions in a
|
||||||
|
.Tn Sun
|
||||||
|
disk label yet.
|
||||||
Loading…
Reference in New Issue
Block a user