blkid_do_fullprobe ()

int
blkid_do_fullprobe (blkid_probe pr);

This function gathers probing results from all enabled chains. Same as blkid_do_safeprobe() but does not check for collision between probing result.

This is string-based NAME=value interface only.

blkid_do_wipe ()

int
blkid_do_wipe (blkid_probe pr,
               int dryrun);

This function erases the current signature detected by pr . The pr has to be open in O_RDWR mode, BLKID_SUBLKS_MAGIC or/and BLKID_PARTS_MAGIC flags has to be enabled (if you want to erase also superblock with broken check sums then use BLKID_SUBLKS_BADCSUM too).

After successful signature removing the pr prober will be moved one step back and the next blkid_do_probe() call will again call previously called probing function. All in-memory cached data from the device are always reset.

1
2
3
4
5
6
7
8

fd = open(devname, O_RDWR|O_CLOEXEC);
blkid_probe_set_device(pr, fd, 0, 0);

blkid_probe_enable_superblocks(pr, 1);
blkid_probe_set_superblocks_flags(pr, BLKID_SUBLKS_MAGIC);

while (blkid_do_probe(pr) == 0)
	blkid_do_wipe(pr, FALSE);

See also blkid_probe_step_back() if you cannot use this built-in wipe function, but you want to use libblkid probing as a source for wiping.

See also blkid_wipe_all() which works the same as the example above.

blkid_wipe_all ()

int
blkid_wipe_all (blkid_probe pr);

This function erases all detectable signatures from &pr. The pr has to be open in O_RDWR mode. All other necessary configurations will be enabled automatically.

1
2
3
4

fd = open(devname, O_RDWR|O_CLOEXEC);
blkid_probe_set_device(pr, fd, 0, 0);

blkid_wipe_all(pr);

blkid_do_probe ()

int
blkid_do_probe (blkid_probe pr);

Calls probing functions in all enabled chains. The superblocks chain is enabled by default. The blkid_do_probe() stores result from only one probing function. It's necessary to call this routine in a loop to get results from all probing functions in all chains. The probing is reset by blkid_reset_probe() or by filter functions.

This is string-based NAME=value interface only.

1
2
3
4
5
6
7

if (blkid_do_probe(pr) == BLKID_PROBE_OK) {
	int nvals = blkid_probe_numof_values(pr);
	for (n = 0; n < nvals; n++) {
		if (blkid_probe_get_value(pr, n, &name, &data, &len) == 0)
			printf("%s = %s\n", name, data);
	}
}

1
2
3
4

while (blkid_do_probe(pr) == BLKID_PROBE_OK) {
	int nvals = blkid_probe_numof_values(pr);
	...
}

See also blkid_reset_probe().

blkid_do_safeprobe ()

int
blkid_do_safeprobe (blkid_probe pr);

This function gathers probing results from all enabled chains and checks for ambivalent results (e.g. more filesystems on the device).

This is string-based NAME=value interface only.

Note about superblocks chain -- the function does not check for filesystems when a RAID signature is detected. The function also does not check for collision between RAIDs. The first detected RAID is returned. The function checks for collision between partition table and RAID signature -- it's recommended to enable partitions chain together with superblocks chain.

blkid_probe_get_value ()

int
blkid_probe_get_value (blkid_probe pr,
                       int num,
                       const char **name,
                       const char **data,
                       size_t *len);

Note, the len returns length of the data , including the terminating '\0' character.

blkid_probe_has_value ()

int
blkid_probe_has_value (blkid_probe pr,
                       const char *name);

blkid_probe_lookup_value ()

int
blkid_probe_lookup_value (blkid_probe pr,
                          const char *name,
                          const char **data,
                          size_t *len);

Note, the len returns length of the data , including the terminating '\0' character.

blkid_probe_numof_values ()

int
blkid_probe_numof_values (blkid_probe pr);