gd_protection3
Report the protection level of a dirfile fragment
Usage
#include <getdata.h>
int gd_protection(DIRFILE *dirfile, int fragment_index);
Overview
The gd_protection() function queries a dirfile(5) database specified by dirfile and determines the advisory protection level for the fragment indexed by fragment_index.
Return value
Upon successful completion, gd_protection() returns a non-negative integer indicating the the advisory protection level of the specified fragment. This integer will equal one of the following symbols:
-
GD_PROTECT_NONE,GD_PROTECT_FORMAT,GD_PROTECT_DATA,GD_PROTECT_ALL.
The meaning of these symbols are explained in the gd_alter_protection(3) man page. On error, it returns a negative-valued error code. Possible error codes are:
.TP 8 GD_E_BAD_DIRFILE The supplied dirfile was invalid.
.TP 8 GD_E_BAD_INDEX The supplied index was out of range.
The error code is also stored in the DIRFILE object and may be retrieved after this function returns by calling gd_error(3). A descriptive error string for the error may be obtained by calling gd_error_string(3).
Releases
7 releases since Debian 7 (Wheezy); the text changed 1 time.