The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

getuserattr (3)
  • >> getuserattr (3) ( Solaris man: Библиотечные вызовы )
  •  

    NAME

    getuserattr, getusernam, getuseruid, free_userattr, setuserattr, enduserattr, fgetuserattr - get user_attr entry
     
    

    SYNOPSIS

    cc [ flag... ] file... -lsecdb  -lsocket  -lnsl [ library... ]
    #include <user_attr.h> 
    
    userattr_t *getuserattr(void);
    

    userattr_t *getusernam(const char *name);
    

    userattr_t *getuseruid(uid_t uid);
    

    void free_userattr(userattr_t *userattr);
    

    void setuserattr(void);
    

    void enduserattr(void);
    

    userattr_t *fgetuserattr(FILE *f);
    

     

    DESCRIPTION

    The getuserattr(), getusernam(), and getuseruid() functions each return a user_attr(4) entry. Entries can come from any of the sources specified in the nsswitch.conf(4) file. The getuserattr() function enumerates user_attr entries. The getusernam() function searches for a user_attr entry with a given user name name. The getuseruid() function searches for a user_attr entry with a given user ID uid. Successive calls to these functions return either successive user_attr entries or NULL.

    The fgetuserattr() function does not use nsswitch.conf but reads and parses the next line from the stream f. This stream is assumed to have the format of the user_attr files.

    The free_userattr() function releases memory allocated by the getusernam(), getuserattr(), and fgetuserattr() functions.

    The internal representation of a user_attr entry is a userattr_t structure defined in <user_attr.h> with the following members:

    char  *name;       /* name of the user */
    char  *qualifier;  /* reserved for future use */
    char  *res1;       /* reserved for future use */
    char  *res2;       /* reserved for future use */
    kva_t *attr;       /* list of attributes */
    

    The setuserattr() function "rewinds" to the beginning of the enumeration of user_attr entries. Calls to getusernam() may leave the enumeration in an indeterminate state, so setuserattr() should be called before the first call to getuserattr().

    The enduserattr() function may be called to indicate that user_attr processing is complete; the library may then close any open user_attr file, deallocate any internal storage, and so forth.  

    RETURN VALUES

    The getuserattr() function returns a pointer to a userattr_t if it successfully enumerates an entry; otherwise it returns NULL, indicating the end of the enumeration.

    The getusernam() function returns a pointer to a userattr_t if it successfully locates the requested entry; otherwise it returns NULL.  

    USAGE

    The getuserattr() and getusernam() functions both allocate memory for the pointers they return. This memory should be deallocated with the free_userattr() function.

    Individual attributes can be referenced in the attr structure by calling the kva_match(3SECDB) function.  

    WARININGS

    Because the list of legal keys is likely to expand, code must be written to ignore unknown key-value pairs without error.  

    FILES

    /etc/user_attr

    extended user attributes

    /etc/nsswitch.conf

    configuration file lookup information for the name server switch

     

    ATTRIBUTES

    See attributes(5) for descriptions of the following attributes:

    ATTRIBUTE TYPEATTRIBUTE VALUE

    MT-LevelMT-Safe

     

    SEE ALSO

    getauthattr(3SECDB), getexecattr(3SECDB), getprofattr(3SECDB), user_attr(4), attributes(5)


     

    Index

    NAME
    SYNOPSIS
    DESCRIPTION
    RETURN VALUES
    USAGE
    WARININGS
    FILES
    ATTRIBUTES
    SEE ALSO


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру