Section 3: library functions
NAME dirfile_protect — modify the protection level of a dirfile fragment SYNOPSIS #include <getdata.h> int dirfile_protect(DIRFILE *dirfile, int protection_level, int fragment_index); DESCRIPTION The dirfile_protect() function sets the advisory protection level of the format file fragment specified by fragment_index to protection_level in the dirfile(5) database specified by dirfile. The protection_level argument should be one of the…
NAME dirfile_parser_callback — set the syntax error callback handler for a dirfile SYNOPSIS #include <getdata.h> void dirfile_parser_callback(DIRFILE *dirfile, gd_parser_callback_t sehandler, void *extra); DESCRIPTION The dirfile_parser_callback() updates the syntax error callback function of the DIRFILE object dirfile to be sehandler, and the caller supplied extra pointer passed to the handler to be extra, discarding any syntax…
NAME dirfile_cbopen, dirfile_open — open or create a dirfile SYNOPSIS #include <getdata.h> DIRFILE* dirfile_cbopen(const char *dirfilename, unsigned long flags, gd_parser_callback_t sehandler, void *extra); DIRFILE* dirfile_open(const char *dirfilename, unsigned long flags); DESCRIPTION The dirfile_cbopen() function opens or creates the dirfile specified by dirfilename, returning a DIRFILE object associated with it. Opening a dirfile will cause the…
NAME dirfile_move — move a dirfile field between format file fragments SYNOPSIS #include <getdata.h> int dirfile_move(DIRFILE *dirfile, const char *field_code, int new_fragment, int move_data); DESCRIPTION The dirfile_move() function transfers the field specified by field_code, which should not have a representation suffix, defined in the dirfile specified by dirfile from it’s current format file fragment to…
NAME dirfile_metaflush — close a dirfile and free associated memory. SYNOPSIS #include <getdata.h> int dirfile_metaflush(DIRFILE *dirfile); DESCRIPTION The dirfile_metaflush() function flushes all pending metadata changes in the dirfile specified by dirfile to disk. This is accomplished by re-writing the format file fragments containing modified metadata. Format file fragments which are unchanged are not touched. This…
NAME dirfile_alter_spec, dirfile_malter_spec — modify a field in a dirfile SYNOPSIS #include <getdata.h> int dirfile_alter_spec(DIRFILE *dirfile, const char *line, int recode); int dirfile_malter_spec(DIRFILE *dirfile, const char *line, const char *parent, int recode); DESCRIPTION The dirfile_alter_spec() function modifies the field described by the field specification line in line to the dirfile specified by dirfile. The dirfile_malter_spec()…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_add_spec, dirfile_madd_spec — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_add_spec(DIRFILE *dirfile, const char *line, int fragment_index); int dirfile_madd_spec(DIRFILE *dirfile, const char *line, const char *parent); DESCRIPTION The dirfile_add_spec() function adds the field described by the field specification line in line to the dirfile specified by dirfile. The dirfile_madd_spec() function behaves…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_madd_bit, dirfile_madd_clincom, dirfile_madd_const, dirfile_madd_cpolynom, dirfile_madd_lincom, dirfile_madd_linterp, dirfile_madd_multiply, dirfile_madd_phase, dirfile_madd_polynom, dirfile_madd_bit, dirfile_madd_string — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_madd_bit(DIRFILE *dirfile, const char *parent, const char *field_name, const char *in_field, gd_bit_t bitnum, gd_bit_t numbits); int dirfile_madd_clincom(DIRFILE *dirfile, const char *parent, const char *field_name, int n_fields, const char **in_fields, const double complex…
NAME dirfile_add, dirfile_madd — add a field to a dirfile SYNOPSIS #include <getdata.h> int dirfile_add(DIRFILE *dirfile, const gd_entry_t *entry); int dirfile_madd(DIRFILE *dirfile, const gd_entry_t *entry, const char *parent); DESCRIPTION The dirfile_add() function adds the field described by entry to the dirfile specified by dirfile. The dirfile_madd() function behaves similarly, but adds the field as a…
NAME dirfile_include — add a format file fragment to a dirfile SYNOPSIS #include <getdata.h> int dirfile_include(DIRFILE *dirfile, const char *include_file, int parent_fragment, unsigned long flags); DESCRIPTION The dirfile_include() adds the format file fragment specified by the path include_file to the specified dirfile, possibly creating the fragment. This occurs as if, in the existing fragment indexed…