setaliasent,  endaliasent,  getaliasent, getaliasent_r, getaliasbyname,
   getaliasbyname_r - read an alias entry


   #include <aliases.h>

   void setaliasent(void);

   void endaliasent(void);

   struct aliasent *getaliasent(void);

   int getaliasent_r(struct aliasent *result,
           char *buffer, size_t buflen, struct aliasent **res);

   struct aliasent *getaliasbyname(const char *name);

   int getaliasbyname_r(const char *name, struct aliasent *result,
           char *buffer, size_t buflen, struct aliasent **res);


   One of the databases available with the Name Service  Switch  (NSS)  is
   the  aliases  database, that contains mail aliases.  (To find out which
   databases  are  supported,  try  getent  --help.)   Six  functions  are
   provided to access the aliases database.

   The  getaliasent() function returns a pointer to a structure containing
   the group information from the aliases database.  The first time it  is
   called  it  returns  the first entry; thereafter, it returns successive

   The setaliasent() function rewinds the file pointer to the beginning of
   the aliases database.

   The endaliasent() function closes the aliases database.

   getaliasent_r() is the reentrant version of the previous function.  The
   requested structure is stored via the first argument but the programmer
   needs  to  fill  the  other arguments also.  Not providing enough space
   causes the function to fail.

   The function getaliasbyname() takes the name argument and searches  the
   aliases  database.   The  entry  is  returned  as a pointer to a struct

   getaliasbyname_r() is the reentrant version of the  previous  function.
   The  requested  structure  is  stored  via  the second argument but the
   programmer needs to fill  the  other  arguments  also.   Not  providing
   enough space causes the function to fail.

   The struct aliasent is defined in <aliases.h>:

       struct aliasent {
           char    *alias_name;             /* alias name */
           size_t   alias_members_len;
           char   **alias_members;          /* alias name list */
           int      alias_local;


   The  functions  getaliasent_r() and getaliasbyname_r() return a nonzero
   value on error.


   The default alias database is  the  file  /etc/aliases.   This  can  be
   changed in the /etc/nsswitch.conf file.


   For   an   explanation   of   the  terms  used  in  this  section,  see

   │InterfaceAttributeValue          │
   │setaliasent(),      │ Thread safety │ MT-Safe locale │
   │endaliasent(),      │               │                │
   │getaliasent_r(),    │               │                │
   │getaliasbyname_r()  │               │                │
   │getaliasent(),      │ Thread safety │ MT-Unsafe      │
   │getaliasbyname()    │               │                │


   These  routines  are  glibc-specific.   The  NeXT  system  has  similar

       #include <aliasdb.h>

       void alias_setent(void);
       void alias_endent(void);
       alias_ent *alias_getent(void);
       alias_ent *alias_getbyname(char *name);


   The  following example compiles with gcc example.c -o example.  It will
   dump all names in the alias database.

   #include <aliases.h>
   #include <stdio.h>
   #include <stdlib.h>
   #include <errno.h>

       struct aliasent *al;
       for (;;) {
           al = getaliasent();
           if (al == NULL)
           printf("Name: %s\n", al->alias_name);
       if (errno) {
           perror("reading alias");


   getgrent(3), getpwent(3), getspent(3), aliases(5)


   This page is part of release 4.09 of the Linux  man-pages  project.   A
   description  of  the project, information about reporting bugs, and the
   latest    version    of    this    page,    can     be     found     at

More Linux Commands

attributes(3pm) - get/set subroutine or variable attributes
Subroutine declarations and definitions may optionally have attribute lists associated with them. (Variable my declarations also may, but see the warning below.

directfbrc(5) - DirectFB configuration file - Linux man page
The directfbrc file is a configuration file read by all DirectFB applications on startup. There are two of these: a system-wide one stored in /etc/directfbrc an

ldap_count_references(3) - Stepping through continuation ref
These routines are used to step through the continuation references in a result chain received from ldap_result(3) or the synchronous LDAP search operation rout

madvise(2) - give advice about use of memory (Man Page).....
The madvise() system call advises the kernel about how to handle paging input/output in the address range beginning at address addr and with size length bytes.

gnutls_x509_crt_list_import(3) - API function (Man Page)....
gnutls_x509_crt_list_import.3 - This function will convert the given PEM encoded certificate list to the native gnutls_x509_crt_t format. The output will be sto

Tcl_GetUnicode(3) - manipulate Tcl objects as strings.......
The procedures described in this manual entry allow Tcl objects to be manipulated as string values. They use the internal representation of the object to store

gnutls_openpgp_privkey_sign_hash(3) - API function (ManPage)
This function will sign the given hash using the private key. You should use gnutls_openpgp_privkey_set_preferred_key_id() before calling this function to set t

linphone(1) - Gnome interface of linphone, a SIP compatible
Linphone can be started without any extra argument. All parameters are accessible from the property box. OPTIONS --help Output help information and exit. --vers

XSegment(3) - draw lines, polygons, and line structure......
The XDrawLine function uses the components of the specified GC to draw a line between the specified set of points (x1, y1) and (x2, y2). It does not perform joi

ctl_mboxlist(8) - perform operations on the mailbox list dat
Ctl_mboxlist is used to perform various administrative operations on the mailbox list database. Ctl_mboxlist reads its configuration options out of the

aspell-import(1) import old personal dictionaries into GNU A
aspell-import is a command that will search for old personal dictionaries and will import them into GNU Aspell. It will look for both Ispell and Aspell dictiona

sane-epson2(5) - SANE backend for EPSON scanners (Man Page)
The sane-epson2 library implements a SANE (Scanner Access Now Easy) backend that provides access to Epson flatbed scanners. This library supports a similar set

We can't live, work or learn in freedom unless the software we use is free.