svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
getprojbyname(3project)
ge...nt(3PROJECT) Project Database Access Library Functions ge...nt(3PROJECT)
NAME
getprojent, getprojbyname, getprojbyid, getdefaultproj, inproj, getpro‐
jidbyname, setprojent, endprojent, fgetprojent - project database entry
operations
SYNOPSIS
cc [ flag... ] file... −lproject [ library... ]
#include <project.h>
struct project *getprojent(struct project *proj, void *buffer,
size_t bufsize);
struct project *getprojbyname(const char *name,
struct project *proj, void *buffer, size_t bufsize);
struct project *getprojbyid(projid_t projid,
struct project *proj, void *buffer, size_t bufsize);
struct project *getdefaultproj(const char *username,
struct project *proj, void *buffer, size_t bufsize);
int inproj(const char *username, const char *projname,
void *buffer, size_t bufsize);
projid_t getprojidbyname(const char *name);
void setprojent(void);
void endprojent(void);
struct project *fgetprojent(FILE *f, struct project *proj,
void *buffer, size_t bufsize);
DESCRIPTION
These functions are used to obtain entries describing user projects.
Entries can come from any of the sources for a project specified in the
nsswitch.conf(5) configuration.
The setprojent(), getprojent(), and endprojent() functions are used to
enumerate project entries from the database.
The setprojent() function effectively rewinds the project database to
allow repeated searches. It sets (or resets) the enumeration to the be‐
ginning of the set of project entries. This function should be called
before the first call to getprojent().
The getprojent() function returns a pointer to a structure containing
the broken-out fields of an entry in the project database. When first
called, getprojent() returns a pointer to a project structure contain‐
ing the first project structure in the project database. Successive
calls can be used to read the entire database.
The endprojent() function closes the project database and deallocates
resources when processing is complete. It is permissible, though possi‐
bly less efficient, for the process to call more project functions af‐
ter calling endprojent().
The getprojbyname() function searches the project database for an entry
with the project name specified by the character string name.
The getprojbyid() function searches the project database for an entry
with the (numeric) project ID specified by projid.
The getdefaultproj() function behaves as follows:
o It searches for a named project defined by the "project"
keyword in the user's user_attr entry. If no match is found,
or if the user is excluded from that project, it proceeds to
the next search. Otherwise, the project pointer is returned.
o It searches for a project with a naming pattern of
"user.user_name" where user_name is the user's login name.
If no match is found, or if the user is excluded from that
project, it proceeds to the next search. Otherwise, the
project pointer is returned.
o It searches for a project with a naming pattern of
"group.group_name" where group_name is the user's primary
group name. If no match is found, or if the user is excluded
from that project, it proceeds to the next search. Other‐
wise, the project pointer is returned.
o It searches for a project named "default". If no match is
found, or if the user is excluded from that project, it re‐
turns NULL. Otherwise, the project pointer is returned.
The inproj() function checks if the user specified by username is able
to use the project specified by projname. It returns 1 if the project
is the user's default project, the user is not explicitly excluded from
that project's users list, and the user is not explicitly excluded from
that project's groups list. It also returns 1 if the project is a nor‐
mal project, the user is not explicitly excluded from and is explicitly
included in that project's users list, and the user is not explicitly
excluded from and is explicitly included in that project's groups list.
It returns 0 for all other cases.
A user is considered explicitly excluded from a project's users list if
there exists a "!*" or a "!user_name" token, where user_name is the
user's login name.
A user is considered explicitly included in a project's users list if
there exists a "*" or a "user_name" token, where user_name is the
user's login name.
A user is considered explicitly excluded in a project's groups list if
there exists a "!*" or a "!group_name" token, where group_name is the
user's primary group name or the name of a group to which the user be‐
longs.
A user is considered explicitly included in a project's groups list if
there exists a "*" or a "group_name" token, where group_name is the
user's primary group name or the name of a group to which the user be‐
longs.
The getprojidbyname() function searches the project database for an en‐
try with the project name specified by the character string name. This
function returns the project ID if the requested entry is found; other‐
wise it returns −1.
The fgetprojent() function, unlike the other functions described above,
does not use nsswitch.conf; it reads and parses the next line from the
stream f, which is assumed to have the format of the project(5) file.
This function returns the same values as getprojent().
The getprojent(), getprojbyname(), getprojbyid(), getdefaultproj(), and
inproj() functions are reentrant interfaces for operations with the
project database. These functions use buffers supplied by the caller to
store returned results and are safe for use in both single-threaded and
multithreaded applications.
Reentrant interfaces require the additional arguments proj, buffer, and
bufsize. The proj argument must be a pointer to a struct project struc‐
ture allocated by the caller. On successful completion, the function
returns the project entry in this structure. Storage referenced by the
project structure is allocated from the memory provided with the buffer
argument, which is bufsize bytes in size. The content of the memory
buffer could be lost in cases when these functions return errors.
For enumeration in multithreaded applications, the position within the
enumeration is a process-wide property shared by all threads. The set‐
projent() function can be used in a multithreaded application but re‐
sets the enumeration position for all threads. If multiple threads in‐
terleave calls to getprojent(), the threads will enumerate disjoint
subsets of the project database. The inproj(), getprojbyname(), getpro‐
jbyid(), and getdefaultproj() functions leave the enumeration position
in an indeterminate state.
RETURN VALUES
Project entries are represented by the struct project structure defined
in <project.h>.
struct project {
char *pj_name; /* name of the project */
projid_t pj_projid; /* numerical project id */
char *pj_comment; /* project comment */
char **pj_users; /* vector of pointers to
project user names */
char **pj_groups; /* vector of pointers to
project group names */
char *pj_attr; /* project attributes */
};
The getprojbyname() and getprojbyid() functions each return a pointer
to a struct project if they successfully locate the requested entry;
otherwise they return NULL.
The getprojent() function returns a pointer to a struct project if it
successfully enumerates an entry; otherwise it returns NULL, indicating
the end of the enumeration.
The getprojidbyname() function returns the project ID if the requested
entry is found; otherwise it returns −1 and sets errno to indicate the
error.
When the pointer returned by the reentrant functions getprojbyname(),
getprojbyid(), and getprojent() is non-null, it is always equal to the
proj pointer that was supplied by the caller.
Upon failure, NULL is returned and errno is set to indicate the error.
ERRORS
The getprojent(), getprojbyname(), getprojbyid(), inproj(), getprojid‐
byname(), fgetprojent(), and getdefaultproj() functions will fail if:
EINTR A signal was caught during the operation.
EIO An I/O error has occurred.
EMFILE There are OPEN_MAX file descriptors currently open in the
calling process.
ENFILE The maximum allowable number of files is currently open in
the system.
ERANGE Insufficient storage was supplied by buffer and bufsize to
contain the data to be referenced by the resulting project
structure.
These functions can also fail if the name service switch does not spec‐
ify valid project(5) name service sources. In the case of an incom‐
pletely configured name service switch configuration, getprojbyid() and
other functions can return error values other than those documented
above. These conditions usually occur when the nsswitch.conf configura‐
tion indicates that one or more name services is providing entries for
the project database when that name service does not actually make a
project table available.
USAGE
Use of the enumeration interface getprojent() is discouraged. Enumera‐
tion is supported for the project file, NIS, and LDAP but in general is
not efficient. The semantics of enumeration are discussed further in
nsswitch.conf(5).
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.63i) |cw(2.87i) lw(2.63i) |lw(2.87i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSee Description.
SEE ALSO
sysconf(3C), libproject(3LIB), project_walk(3PROJECT), nss‐
witch.conf(5), project(5), attributes(7)
Oracle Solaris 11.4 6 Oct 2022 ge...nt(3PROJECT)