Either of these commands create a partition on the system and use the following syntax:
part [mntpoint
] partition [mntpoint
]
If you do not provide mntpoint
, Wic
creates a partition but does not mount it.
The
is
where the partition will be mounted and must be of one of the
following forms:
mntpoint
/
:
For example, "/", "/usr", or "/home"
path
swap
:
The created partition is used as swap space.
Specifying a mntpoint
causes the
partition to automatically be mounted.
Wic achieves this by adding entries to the filesystem table (fstab)
during image generation.
In order for wic to generate a valid fstab, you must also provide
one of the --ondrive
,
--ondisk
, or
--use-uuid
partition options as part of the
command.
Here is an example using "/" as the mountpoint.
The command uses "--ondisk" to force the partition onto the
sdb
disk:
part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024
Here is a list that describes other supported options you can use
with the part
and
partition
commands:
--size
:
The minimum partition size in MBytes.
Specify an integer value such as 500.
Do not append the number with "MB".
You do not need this option if you use
--source
.
--source
:
This option is a Wic-specific option that names the source
of the data that populates the partition.
The most common value for this option is "rootfs", but you
can use any value that maps to a valid source plug-in.
For information on the source plug-ins, see the
"Wic Plug-Ins Interface"
section.
If you use --source rootfs
, Wic
creates a partition as large as needed and to fill it with
the contents of the root filesystem pointed to by the
-r
command-line option or the
equivalent rootfs derived from the -e
command-line option.
The filesystem type used to create the partition is driven
by the value of the --fstype
option
specified for the partition.
See the entry on --fstype
that follows
for more information.
If you use
--source
,
Wic creates a partition as large as needed and fills it
with the contents of the partition that is generated by the
specified plug-in name using the data pointed to by the
plugin-name
-r
command-line option or the
equivalent rootfs derived from the -e
command-line option.
Exactly what those contents and filesystem type end up
being are dependent on the given plug-in implementation.
If you do not use the --source
option, the wic
command creates an
empty partition.
Consequently, you must use the --size
option to specify the size of the empty partition.
--ondisk
or --ondrive
:
Forces the partition to be created on a particular disk.
--fstype
:
Sets the file system type for the partition.
Valid values are:
ext4
ext3
ext2
btrfs
squashfs
swap
--fsoptions
:
Specifies a free-form string of options to be used when
mounting the filesystem.
This string will be copied into the
/etc/fstab
file of the installed
system and should be enclosed in quotes.
If not specified, the default string is "defaults".
--label label
:
Specifies the label to give to the filesystem to be made on
the partition.
If the given label is already in use by another filesystem,
a new label is created for the partition.
--active
:
Marks the partition as active.
--align (in KBytes)
:
This option is a Wic-specific option that says to start a
partition on an x
KBytes
boundary.
--no-table
:
This option is a Wic-specific option.
Using the option reserves space for the partition and
causes it to become populated.
However, the partition is not added to the partition table.
--extra-space
:
This option is a Wic-specific option that adds extra space
after the space filled by the content of the partition.
The final size can go beyond the size specified by the
--size
option.
The default value is 10 Mbytes.
--overhead-factor
:
This option is a Wic-specific option that multiplies the
size of the partition by the option's value.
You must supply a value greater than or equal to "1".
The default value is "1.3".
--part-type
:
This option is a Wic-specific option that specifies the
partition type globally unique identifier (GUID) for GPT
partitions.
You can find the list of partition type GUIDs at
http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs.
--use-uuid
:
This option is a Wic-specific option that causes Wic to
generate a random GUID for the partition.
The generated identifier is used in the bootloader
configuration to specify the root partition.
--uuid
:
This option is a Wic-specific option that specifies the
partition UUID.