summaryrefslogtreecommitdiffstats
path: root/libfdisk/src/field.c
blob: e924cf81fea7341ae583a9748c20f4d041c2319d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
#include "fdiskP.h"

/**
 * SECTION: field
 * @title: Field
 * @short_description: description of the partition fields
 *
 * The fdisk fields are static user-friendly descriptions of the partition. The
 * fields are used to avoid label specific stuff in the functions that list disk
 * partitions (e.g. fdisk -l). The field Id is the same as Id for fdisk_partition_to_string().
 *
 * <informalexample>
 *   <programlisting>
 * int *ids;
 * size_t nids;
 * struct fdisk_partition *pa = NULL;
 * struct fdisk_label *lb = fdisk_get_label(cxt, NULL);
 *
 * fdisk_label_get_fields_ids(lb, cxt, &ids, &nids);
 *
 * fdisk_get_partition(cxt, 0, &pa);
 *
 * for (i = 0; i < nids; i++) {
 *	const struct fdisk_field *field = fdisk_label_get_field(lb, ids[i]);
 *
 *	int id = fdisk_field_get_id(fl);
 *	const char *name = fdisk_field_get_name(fl);
 *	char *data;
 *
 *	fdisk_partition_to_string(pa, id, &data);
 *	printf("%s: %s\n", name, data);
 *	free(data);
 * }
 * free(ids);
 *    </programlisting>
 * </informalexample>
 *
 * This example lists all information about the first partition. It will work
 * for MBR as well as for GPT because fields are not hardcoded in the example.
 *
 * See also fdisk_label_get_field_by_name(), fdisk_label_get_fields_ids_all()
 * and fdisk_label_get_fields_ids().
 */

/**
 * fdisk_field_get_id:
 * @field: field instance
 *
 * Returns: field Id (FDISK_FIELD_*)
 */
int fdisk_field_get_id(const struct fdisk_field *field)
{
	return field ? field->id : -EINVAL;
}

/**
 * fdisk_field_get_name:
 * @field: field instance
 *
 * Returns: field name
 */
const char *fdisk_field_get_name(const struct fdisk_field *field)
{
	return field ? field->name : NULL;
}

/**
 * fdisk_field_get_width:
 * @field: field instance
 *
 * Returns: libsmartcols compatible width.
 */
double fdisk_field_get_width(const struct fdisk_field *field)
{
	return field ? field->width : -EINVAL;
}

/**
 * fdisk_field_is_number:
 * @field: field instance
 *
 * Returns: 1 if field represent number
 */
int fdisk_field_is_number(const struct fdisk_field *field)
{
	return field->flags ? field->flags & FDISK_FIELDFL_NUMBER : 0;
}