Enable partition wipe to remove any old filesystem/RAID signature when
adding a new partition.
For example, when adding a new partition in the same start/end where a
previous filesystem was created.
parttypes can be either:
- A code for MBR/DOS
- An UUID for GPT
User needs a label instance before using a parttype getter. If checking
for a parttype using a code, check if the current label support that
kind of parttype identification before retrieving it. Same applies for
UUID based parttypes.
If wrong identity type is used, raise an exception. Errors regarding
parttype are more informative this way.
'string' getter wraps fdisk_parttype_get_string to fetch the partition
type UUID in case of a GPT label device.
This is useful to confirm or check the partition type UUID of any device
with a GPT label.
>>> import fdisk
>>> cxt = fdisk.Context('./disk.bin', readonly=False)
>>> pa = cxt.partitions[0]
>>> pa.type.string
'C12A7328-F81F-11D2-BA4B-00A0C93EC93B'
>>> pa.type.name
'EFI System'
Fixes a bug where calling assign_device with readonly keyword parameter
raises exception stating it takes no keyword arguments.
Context_assign_device has positional and keyword arguments. Adds
flags METH_KEYWORDS in method declaration (see Context_methods).
Replaces format string in PyArg_ParseTupleAndKeywords from "s|p" to
"s|$p". Adds $ after |, meaning all later optional arguments are
also keyword only.
(See https://docs.python.org/3/c-api/arg.html#other-objects)
Empty names in the kwlist array correspond to positional arguments.
Replaces fname variable name with device for better readability.
Fixes 88c7374db2
("context: check self->cxt and rc in assign_device")
Assert self->cxt before calling libfdisk fdisk_assign_device.
Also check for its return code and raise exception if libfdisk report
any error assigning the device.
Adds label information to context repr function.
%R is used to get the repr result of a PyObject, in this case this
object is the LabelObject representing the context's label information.
Helps showing more of the context information when printing out a
context object instance.
>>> import fdisk
>>> cxt = fdisk.Context('disk.bin')
>>> cxt
<libfdisk.Context object at 0x7fec52f39330, label=<libfdisk.Label object
at 0x7fec52f39310, name=gpt>, details=True, readonly=False>
It's not necessary to store the label in the context type, instead use
the corresponding library function to get the current in-memory label
container.
The device label information is stored in-memory by libfdisk library
when creating a context or assigning a device.
Avoids possible incosistencies between libfdisk in-memory label and
python-libfdisk context type label information.
Allows creation of a context object or device assign if no label
is present in the device.
This case is not frecuent but not critical, do not raise an exception.
For example, a brand new disk with no label or a raw virtual disk
image with no label.
Some of python-libfdisk is inspired by the python bindings of libmount
(from util-linux project).
Remove a comment from pylibmount that slipped into python-libfdisk
python-libfdisk raises Python exceptions when the libfdisk reports an
error when executing some function. libfdisk returns negative
errno values when reporting some error.
Adds utility function to set PyErr string based on the strerror of
a given errno code. Useful when raising Python exceptions.
Only two line breaks separate copyright notice from source.
For the rest of the source file any function declaration or similar
block is separated with a line break from any other block.
Except when a python function definition is previously followed by
a docstring #define block.
libfdisk context add_partition function initializes a passed argument
with the new partition's partno.
If add_partition is successful, return its partno.
Partition type getset enables modifying and getting the type
of a give libfdisk partition.
The type of a partition is defined using PartType, which
can only be instanced via label specific functions
get_parttype_from_string or get_parttype_from_code.
For example, to set the type of a new partitions to 'EFI System':
>>> import fdisk
>>> pa = fdisk.Partition()
>>> pa.type
>>> cxt = fdisk.Context('./disk.bin', readonly=False)
>>> cxt.create_disklabel('gpt')
>>> efitype = cxt.label.get_parttype_from_string("c12a7328-f81f-11d2-ba4b-00a0c93ec93b")
>>> pa.type = efitype
Following the previous example, getting its current partition type:
>>> pa.type
<libfdisk.PartType object at 0x7f2f0a9a12d0, name=EFI System>
This method wraps fdisk_add_partition. Allows modifying in-memory
partition table of a given context.
Remember that changes need to be written to disk using the
relevant fdisk_write_disklabel function wrapper.
Allows changing in-memory partno field of a Partition instance:
>>> import fdisk
>>> pa = fdisk.Partition()
>>> pa.partno = 3
>>> pa
<libfdisk.Partition object at 0x7f4603a38f30, partno=3>
If partno is unset repr shows 'None':
>>> import fdisk
>>> pa = fdisk.Partition()
>>> pa
<libfdisk.Partition object at 0x7f86c4338f30, partno=None>
Undefined values in libfdisk should map to None type in Python.
Py_BuildValue("%d", -1); is also incorrectly formatted and raises an
error when executed.
Adds wrappers for following label related functions from libfdisk:
- fdisk_create_disklabel
- fdisk_write_disklabel
These functions are declared as methods of a Context python object.
Renames 'cval' to 'szunit' for better readability. This variable is used
to store the size_unit constant that is going to be set using
fdisk_set_size_unit.
fdisk_assign_device() contains 'readonly' parameter to indicate how to
open the device.
Assigned device 'readonly' must be false (0) in order to write in-memory
changes to it.
Call Partition_AddModuleObject when initializing the python module.
Fixes bug when using the Partition class but the class has not
been added to the module via Py_TypeReady.
A common error was the type not being ready (missing attributes):
>>> for pa in cxt.parts:
... print(pa.partno)
...
Traceback (most recent call last):
File "<stdin>", line 2, in <module>
AttributeError: 'libfdisk.Partition' object has no attribute 'partno'
Jose M. Guisado
Jose M. Guisado Gomez