Section 3: library functions
get_rle_sprite – Creates an RLE sprite using a bitmap as source. Allegro game programming library. Synopsis#include <allegro.h> RLE_SPRITE *get_rle_sprite(BITMAP *bitmap); DescriptionCreates an RLE sprite based on the specified bitmap (which must be a memory bitmap). Remember to free this RLE sprite later to avoid memory leaks. Example: RLE_SPRITE *rle; BITMAP *bmp; … /* Create RLE…
dirfile_reference, get_reference — retrieve or set the reference field for a dirfile Synopsis#include <getdata.h> const char *dirfile_reference(DIRFILE *dirfile, const char *field_code); const char *get_reference(DIRFILE *dirfile);DescriptionThe dirfile_reference() function sets or retrieves the reference field (see dirfile(5)) associated with the dirfile specified by dirfile. If the field_code argument is non-NULL, the reference field for the dirfile will…
get_raw_filename — retrieve the pathname of a binary file in a dirfile Synopsis#include <getdata.h> const char *get_raw_filename(DIRFILE *dirfile, const char *field_code);DescriptionThe get_raw_filename() function retrieves the pathname of the file backing the RAW field specified by field_code in the dirfile specified by dirfile. If field_code contains a valid representation suffix, it will be ignored. Return ValueOn…
get_protection — report the protection level of a dirfile fragment Synopsis#include <getdata.h> int get_protection(DIRFILE *dirfile, int fragment_index);DescriptionThe get_protection() function queries a dirfile(5) database specified by dirfile and returns the advisory protection level for the fragment indexed by fragment_index. Return ValueUpon successful completion, get_protection() returns the advisory protection level of the specified fragment, which will be…
get_phys_pages, get_avphys_pages – get total and available physical page counts Synopsis#include <sys/sysinfo.h> long get_phys_pages(void); long get_avphys_pages(void);DescriptionThe function get_phys_pages() returns the total number of physical pages of memory available on the system. The function get_avphys_pages() returns the number of currently available physical pages of memory on the system. Return ValueOn success, these functions return a nonnegative…
get_parent_fragment — retrieve the parent fragment of a fragment in a dirfile Synopsis#include <getdata.h> int get_parent_fragment(const DIRFILE *dirfile, int fragment_index);DescriptionThe get_parent_fragment() function queries a dirfile(5) database specified by dirfile and returns the index of the fragment which contains the INCLUDE directive for the fragment indexed by fragment_index. Since the primary format file fragment is not…
get_palette – Retrieves the entire palette of 256 colors. Allegro game programming library. Synopsis#include <allegro.h> void get_palette(PALETTE p); DescriptionRetrieves the entire palette of 256 colors. You should provide an array of 256 RGB structures to store it in. Example: PALETTE pal; … get_palette(pal);See Alsoget_palette_range(3), get_color(3), set_palette(3)
get_ordered_context_list, get_ordered_context_list_with_level, get_default_context, get_default_context_with_level, get_default_context_with_role, get_default_context_with_rolelevel, query_user_context, manual_user_enter_context, get_default_role – determine SELinux context(s) for user sessions Synopsis#include <selinux/selinux.h> #include <selinux/get_context_list.h> int get_ordered_context_list(const char *user, char *fromcon, char ***list); int get_ordered_context_list_with_level(const char *user, const char *level, char *fromcon, char ***list); int get_default_context(const char *user, char *fromcon, char **newcon); int get_default_context_with_level(const char *user, const char *level, char…
get_ordered_context_list, get_ordered_context_list_with_level, get_default_context, get_default_context_with_level, get_default_context_with_role, get_default_context_with_rolelevel, query_user_context, manual_user_enter_context, get_default_role – determine SELinux context(s) for user sessions Synopsis#include <selinux/selinux.h> #include <selinux/get_context_list.h> int get_ordered_context_list(const char *user, char *fromcon, char ***list); int get_ordered_context_list_with_level(const char *user, const char *level, char *fromcon, char ***list); int get_default_context(const char *user, char *fromcon, char **newcon); int get_default_context_with_level(const char *user, const char *level, char…
get_nvectors — report the number of vector fields in a dirfile Synopsis#include <getdata.h> unsigned int get_nvectors(DIRFILE *dirfile);DescriptionThe get_nvectors() function queries a dirfile(5) database specified by dirfile and returns the number of vector fields defined in the database (i.e. fields of types BIT,~LINCOM,~LINTERP,~MULTIPLY,~PHASE,~POLYNOM,~RAW, SBIT). Notably, this count does not include /META fields. The dirfile argument must…
get_nprocs, get_nprocs_conf – get number of processors Synopsis#include <sys/sysinfo.h> int get_nprocs(void); int get_nprocs_conf(void); DescriptionThe function get_nprocs_conf() returns the number of processors configured by the operating system. The function get_nprocs() returns the number of processors currently available in the system. This may be less than the number returned by get_nprocs_conf() because processors may be offline (e.g.,…
get_nprocs, get_nprocs_conf – get number of processors Synopsis#include <sys/sysinfo.h> int get_nprocs(void); int get_nprocs_conf(void); DescriptionThe function get_nprocs_conf() returns the number of processors configured by the operating system. The function get_nprocs() returns the number of processors currently available in the system. This may be less than the number returned by get_nprocs_conf() because processors may be offline (e.g.,…
get_nmvectors — report the number of vector fields in a dirfile Synopsis#include <getdata.h> unsigned int get_nmvectors(DIRFILE *dirfile);DescriptionThe get_nmvectors() function queries a dirfile(5) database specified by dirfile and returns the number of vector metafields defined in the database (i.e. fields of types BIT, LINCOM, LINTERP, MULTIPLY, PHASE, and RAW)for the supplied parent field. The dirfile argument…
get_nmfields_by_type — report the number of fields of a given type in a dirfile Synopsis#include <getdata.h> unsigned int get_nmfields_by_type(DIRFILE *dirfile, const char *parent, gd_entype_t type);DescriptionThe get_nmfields_by_type() function queries a dirfile(5) database specified by dirfile and returns the number of metafields defined in the database for the supplied parent field. The dirfile argument must point to…
get_nmfields — report the number of metafields in a dirfile Synopsis#include <getdata.h> unsigned int get_nmfields(DIRFILE *dirfile, const char *parent);DescriptionThe get_nmfields() function queries a dirfile(5) database specified by dirfile and returns the number of metafields defined in the database for the parent field specified by parent. The dirfile argument must point to a valid DIRFILE object…
get_nframes64 — report the size of a dirfile with largefile support Synopsis#define _LARGEFILE64_SOURCE #include <getdata.h> off64_t get_nframes64(DIRFILE *dirfile);DescriptionThis version of get_nframes(3) uses a 64-bit offset type, even if off_t is a 32-bit type. It is only available if one defines _LARGEFILE64_SOURCE. If off_t is a 64-bit type (i.e. if _FILE_OFFSET_BITS is defined to be 64),…
get_nframes — report the size of a dirfile Synopsis#include <getdata.h> off_t get_nframes(DIRFILE *dirfile);DescriptionThe get_nframes() function queries a dirfile(5) database specified by dirfile and returns the number of frames in the database. Since different fields may have differing number of frames, the Dirfile Standards (see dirfile(5)) dictate that the number of frames in the database is…
get_nfragments — retrieve the number of format file fragments in a dirfile Synopsis#include <getdata.h> int get_nfragments(const DIRFILE *dirfile);DescriptionThe get_nfragments() function queries a dirfile(5) database specified by dirfile and returns the total number of parsed format file fragments in the database. The dirfile argument must point to a valid DIRFILE object previously created by a call…
get_nfields_by_type — report the number of fields of a given type in a dirfile Synopsis#include <getdata.h> unsigned int get_nfields_by_type(DIRFILE *dirfile, gd_entype_t type);DescriptionThe get_nfields_by_type() function queries a dirfile(5) database specified by dirfile and returns the number of fields of type type defined in the database. Notably, this count does not include /META fields. The dirfile argument…
get_nfields — report the number of fields in a dirfile Synopsis#include <getdata.h> unsigned int get_nfields(DIRFILE *dirfile);DescriptionThe get_nfields() function queries a dirfile(5) database specified by dirfile and returns the number of fields defined in the database. Notably, this count does not include /META fields. The dirfile argument must point to a valid DIRFILE object previously created…