Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

mdocify. Adapt contents to NetBSD. Requested by mrg.

Browse Source
This commit is contained in:
wiz 2002-08-18 23:41:38 +00:00
parent 8a75cdd09b
commit 44bfc91fab
1 changed files with 142 additions and 173 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

315
dist/pdisk/pdisk.8 vendored
View File

@ -1,222 +1,191 @@
.TH PDISK 8 "16 May 2000" "LinuxPPC" "Linux Programmer's Manual" .\" $NetBSD: pdisk.8,v 1.2 2002/08/18 23:41:38 wiz Exp $
.SH NAME .Dd August 19, 2002
pdisk \- Apple partition table editor for Linux .Os
.SH SYNOPSIS .Dt PDISK 8
.B pdisk .Sh NAME
.B "[\-h|\--help]" .Nm pdisk
.br .Nd Apple partition table editor
.B pdisk .Sh SYNOPSIS
.B "[\-i|\--interactive]" .Nm
.br .Op Fl acdhilrv
.B pdisk .\".Op Fl acdhilLprv
.B "[\-l|\--list [name ...]]" .Ar device ...
.br .\".Op Fl -abbr
.B pdisk .\".Op Fl -compute_size
device ... .\".Op Fl -debug
.br .\".Op Fl -help
.B pdisk .\".Op Fl -interactive
.B "[\-v|\--version] [\-r|\--readonly] [\-abbr] [\--logical] [\-c|\--compute_size] [\-p|\--pname] [\-d|\--debug]" .\".Op Fl -list Ar name ...
.SH DESCRIPTION .\".Op Fl -logical
.B pdisk .\".Op Fl -pname
.\".Op Fl -readonly
.\".Op Fl -version
.Sh DESCRIPTION
.Nm
is a menu driven program which partitions disks using the standard Apple is a menu driven program which partitions disks using the standard Apple
disk partitioning scheme described in "Inside Macintosh: Devices". disk partitioning scheme described in "Inside Macintosh: Devices".
It does not support the intel/dos partitioning scheme supported by It does not support the Intel/DOS partitioning scheme supported by
.BR fdisk . .Xr fdisk 8 .
The .Pp
.I device Supported options are:
is usually one of the following: .Bl -tag -width Fl
.It Fl a
.nf Abbreviate the partition types shown in the partition list.
.RS .It Fl c
/dev/sda
/dev/sdb
/dev/sdc
/dev/sdd
/dev/sde
/dev/sdf
/dev/sdg
/dev/hda
/dev/hdb
/dev/hdc
/dev/hdd
.RE
.fi
In standard Linux /dev/sda is the first hard disk on the SCSI bus (i.e. the
one with the lowest id), /dev/sdb is the second hard disk, and so on.
The
.I partition
is a
.I device
name followed by a partition number.
The partition number is the index (starting from one) of the partition
map entry in the partition map.
For example,
.B /dev/sda2
is the partition described by the second entry in the partiton map on /dev/sda.
.SH OPTIONS
.TP
.B \-v | \--version
Prints version number of the
.B pdisk
program.
.TP
.B \-h | \--help
Prints a rather lame set of help messages for the
.B pdisk
program.
.TP
.B \-i | \--interactive
Causes Causes
.B pdisk .Nm
to go into an interactive mode similar to the MacOS version of the program.
.TP
.B \-l | \--list
If no
.IR name s
are present then lists the partition tables for
.BR /dev/sda ,
.BR /dev/sdb ,
etc. ,
.BR /dev/hda ,
.BR /dev/hdb ,
etc. , and
.BR /dev/scd0 ,
.BR /dev/scd1 ,
etc..
Otherwise, lists the partition tables for the specified
.IR name s.
.TP
.B \-r | \--readonly
Prevents
.B pdisk
from writing to the device.
.TP
.B \-c | \--compute_size
Causes
.B pdisk
to always ignore the device size listed in the partition table to always ignore the device size listed in the partition table
and compute the device size by other means. and compute the device size by other means.
.TP .It Fl d
.B \-p | \--pname
Since the default behaviour of
.B pdisk
is to show the Mac volume name, this flag forces
.B pdisk
to show the partition name instead.
.TP
.B \-d | \--debug
Turns on debugging. Doesn't add that much output, but does add Turns on debugging. Doesn't add that much output, but does add
a new command 'x' to the editing commands that accesses an a new command
eclectic bunch of undocumented functionality. .Sq x
.SH "Editing Partition Tables" to the editing commands that accesses an eclectic bunch of
undocumented functionality.
.It Fl h
Prints a short help message.
.It Fl i
Causes
.Nm
to go into an interactive mode similar to the MacOS version of the program.
.It Fl l
If no
.Ar device
argument is given,
.Nm
tries to list partition tables for all available hard drives.
Otherwise,
.Nm
lists the partition tables for the specified
.Ar devices .
.\".It Fl L
.\"Show physical limits of partition in the partition list.
.\"Defaults to on.
.\".It Fl p
.\"Since the default behaviour of
.\".Nm
.\"is to show the Mac volume name, this flag forces
.\".Nm
.\"to show the partition name instead.
.It Fl r
Prevents
.Nm
from writing to the device.
.It Fl v
Prints the version number of
.Nm "" .
.El
.Ss Editing Partition Tables
An argument which is simply the name of a An argument which is simply the name of a
.I device .Ar device
indicates that indicates that
.B pdisk .Nm
should edit the partition table of that device. should edit the partition table of that device.
.Pp
The current top level editing commands are: The current top level editing commands are:
.Bd -unfilled -offset indent
.nf
.RS
h command help
p print the partition table
P (print ordered by base address)
i initialize partition map
s change size of partition map
c create new partition (standard MkLinux type)
C (create with type also specified) C (create with type also specified)
n (re)name a partition c create new partition
d delete a partition d delete a partition
r reorder partition entry in map h command help
w write the partition table i initialize partition map
n (re)name a partition
P (print ordered by base address)
p print the partition table
q quit editing (don't save changes) q quit editing (don't save changes)
r reorder partition entry in map
.RE s change size of partition map
.fi w write the partition table
.Ed
.Pp
Commands which take arguments prompt for each argument in turn. Commands which take arguments prompt for each argument in turn.
You can also type any number of the arguments separated by spaces You can also type any number of the arguments separated by spaces
and those prompts will be skipped. and those prompts will be skipped.
The only exception to typeahead are the confirmation prompts on the The only exception to typeahead are the confirmation prompts on the
.B i .Ic i
and and
.B w .Ic w
commands. commands,
The idea being that if we expect you to confirm the decision we since if we expect you to confirm the decision, we shouldn't undermine
shouldn't undermine that by allowing you to be precipitate about it. that by allowing you to be precipitate about it.
.Pp
Partitions are always specified by their number, Partitions are always specified by their number,
which the index of the partition entry in the partition map. which is the index of the partition entry in the partition map.
Most of the commands will change the index numbers of all partitions Most of the commands will change the index numbers of all partitions
after the affected partition. after the affected partition.
You are advised to print the table as frequently as necessary. You are advised to print the table as frequently as necessary.
.Pp
Creating more than fifteen partitions is not advised. Creating more than fifteen partitions is not advised.
There is currently a bug in the some (all?) of the kernels which causes .\"There is currently a bug in the some (all?) of the kernels which causes
access to the whole disk fail if more than fifteen partitions are in the map. .\"access to the whole disk fail if more than fifteen partitions are in the map.
.Pp
The The
.B c .Ic c
(create new partition) command is the only one with complicated arguments. (create new partition) command is the only one with complicated arguments.
The first argument is the base address (in blocks) of the partition. The first argument is the base address (in blocks) of the partition.
Besides a raw number, you can also specify a partition number followed Besides a raw number, you can also specify a partition number followed
by the letter 'p' to indicate that the first block of the new partition should by the letter
be the same as the first block of that existing free space partition. .Sq p
to indicate that the first block of the new partition should be the same
as the first block of that existing free space partition.
The second argument is the length of the partition in blocks. The second argument is the length of the partition in blocks.
This can be a raw number or can be a partition number followed by the This can be a raw number or can be a partition number followed by the
letter 'p' to use the size of that partition or can be a number followed letter
by 'k', 'm', or 'g' to indicate the size in kilobytes, megabytes, or gigabytes .Sq p
respectively. to use the size of that partition or can be a number followed
by
.Sq k ,
.Sq m ,
or
.Sq g
to indicate the size in kilobytes, megabytes, or gigabytes respectively.
(These are powers of 1024, of course, not powers of 1000.) (These are powers of 1024, of course, not powers of 1000.)
The last argument is the name of the partition. The last argument is the name of the partition.
This can be a single word without quotes, or a string surrounded by This can be a single word without quotes, or a string surrounded by
single or double quotes. single or double quotes.
The type of the created partition is the correct type for MkLinux. The type of the created partition is the correct type for
.Nx .
.Pp
The The
.B C .Ic C
command is identical to the command is identical to the
.B c .Ic c
command, with the addition of a partition type argument after the command, with the addition of a partition type argument after the
other arguments. other arguments.
.Pp
The The
.B n .Ic i
(initalize) command prompts for the size of the device.
.\"This was done to get around a bug in the kernel where it reports the wrong
.\"size for the device.
.Pp
The
.Ic n
(name) command allows the name of a partition to be changed. (name) command allows the name of a partition to be changed.
Note that the various "Apple_Driver" partitions depend Note that the various "Apple_Driver" partitions depend
on the name field for proper functioning. on the name field for proper functioning.
I am not aware of any other partition types with this limitation. We are not aware of any other partition types with this limitation.
.Pp
The The
.B r .Ic r
(reorder) command allows the index number of partitions to be changed. (reorder) command allows the index number of partitions to be changed.
The index numbers are constrained to be a contiguous sequence. The index numbers are constrained to be a contiguous sequence.
.Pp
The The
.B i .Ic w
(initalize) command prompts for the size of the device. (write) command writes the partition map out.
This was done to get around a bug in the kernel where it reports the wrong .\"but there is currently a bug in the interaction between MkLinux and Mach
size for the device. .\"which causes the partition map not to be reinterpreted.
The
.B w
(write) command does write the partition map out,
but there is currently a bug in the interaction between MkLinux and Mach
which causes the partition map not to be reinterpreted.
In order to use the new partition map you must reboot. In order to use the new partition map you must reboot.
.Sh SEE ALSO
.SH BUGS .Xr fdisk 8 ,
.Xr newfs 8
.Sh AUTHORS
.An Eryk Vershen
.Sh BUGS
Some people believe there should really be just one disk partitioning utility. Some people believe there should really be just one disk partitioning utility.
.br .Pp
.B pdisk .Nm
should be able to create HFS partitions that work. should be able to create HFS partitions that work.
.br .Pp
Even more help should be available during user input. Even more help should be available during user input.
.SH "SEE ALSO"
.BR fdisk (8),
.BR mkswap (8),
.BR mkfs (8)
.SH AUTHOR
Eryk Vershen