FreeBSD Manual Pages
getprofattr(3SECDB) getprofattr(3SECDB) NAME getprofattr, getprofnam, free_profattr, setprofattr, endprofattr, get- proflist, free_proflist - get profile description and attributes SYNOPSIS cc [ flag... ] file... -lsecdb -lsocket -lnsl [ library... ] #include <prof_attr.h> profattr_t *getprofattr(void); profattr_t *getprofnam(const char *name); void free_profattr(profattr_t *pd); void setprofattr(void); void endprofattr(void); void getproflist(const char *profname, char **proflist, int *profcnt); void free_proflist(char **proflist, int profcnt); The getprofattr() and getprofnam() functions each return a prof_attr entry. Entries can come from any of the sources specified in the nss- witch.conf(4) file. The getprofattr() function enumerates prof_attr entries. The getprof- nam() function searches for a prof_attr entry with a given name. Suc- cessive calls to these functions return either successive prof_attr en- tries or NULL. The internal representation of a prof_attr entry is a profattr_t struc- ture defined in <prof_attr.h> with the following members: char *name; /* Name of the profile */ char *res1; /* Reserved for future use */ char *res2; /* Reserved for future use */ char *desc; /* Description/Purpose of the profile */ kva_t *attr; /* Profile attributes */ The free_profattr() function releases memory allocated by the getpro- fattr() and getprofnam() functions. The setprofattr() function "rewinds" to the beginning of the enumera- tion of prof_attr entries. Calls to getprofnam() can leave the enumera- tion in an indeterminate state. Therefore, setprofattr() should be called before the first call to getprofattr(). The endprofattr() function may be called to indicate that prof_attr processing is complete; the system may then close any open prof_attr file, deallocate storage, and so forth. The getproflist() function searches for the list of sub-profiles found in the given profname and allocates memory to store this list in proflist. The given profname will be included in the list of sub-pro- files. The profcnt argument indicates the number of items currently valid in proflist. Memory allocated by getproflist() should be freed using the free_proflist() function. The free_proflist() function frees memory allocated by the get- proflist() function. The profcnt argument specifies the number of items to free from the proflist argument. The getprofattr() function returns a pointer to a profattr_t if it suc- cessfully enumerates an entry; otherwise it returns NULL, indicating the end of the enumeration. The getprofnam() function returns a pointer to a profattr_t if it suc- cessfully locates the requested entry; otherwise it returns NULL. Individual attributes in the prof_attr_t structure can be referred to by calling the kva_match(3SECDB) function. Because the list of legal keys is likely to expand, any code must be written to ignore unknown key-value pairs without error. The getprofattr() and getprofnam() functions both allocate memory for the pointers they return. This memory should be deallocated with the free_profattr() function. /etc/security/prof_attr profiles and their descriptions See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ auths(1), profiles(1), getexecattr(3SECDB), getauthattr(3SECDB), prof_attr(4) 31 Mar 2005 getprofattr(3SECDB)
NAME | SYNOPSIS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=getprofattr&sektion=3secdb&manpath=SunOS+5.10>