exportent(3)

NAME
     exportent, getexportent, setexportent, addexportent, remexportent,
     endexportent, getexportopt - get exported file system information

SYNOPSIS
     #include <stdio.h>
     #include <exportent.h>

     FILE *setexportent(void);

     struct exportent *getexportent(FILE *filep);

     int addexportent(FILE *filep, char *dirname, char *options);

     int remexportent(FILE *filep, char *dirname);

     char *getexportopt(struct exportent *xent, char *opt);

     void endexportent(FILE *filep);

DESCRIPTION
     These routines access the exported filesystem information in /etc/xtab.

     setexportent opens the export information file and returns a file pointer
     to use with getexportent, addexportent, remexportent, and endexportent.
     getexportent reads the next line from filep and returns a pointer to an
     object with the following structure containing the broken-out fields of a
     line in the file, /etc/xtab.  The fields have meanings described in
     exports(4).

  #define ACCESS_OPT  ``access''  /* machines that can mount fs */
  #define ROOT_OPT    ``root''    /* machines with root access of fs */
  #define RO_OPT      ``ro''      /* export read-only */
  #define RW_OPT      ``rw''      /* export read-mostly */
  #define ANON_OPT    ``anon''    /* uid for anonymous requests */
  #define NOHIDE_OPT  ``nohide''  /* visible from upper-exported fs */
  struct exportent {
       char *xent_dirname;        /* directory (or file) to export */
       char *xent_options;        /* options, as above */
  };


     addexportent adds the exportent to the end of the open file filep.  It
     returns 0 if successful and  -1 on failure.  remexportent removes the
     indicated entry from the list.  It also returns 0 on success and -1 on
     failure.  getexportopt scans the xent_options field of the exportent
     structure for a substring that matches opt.  It returns the string value
     of opt, or NULL if the option is not found.

     endexportent closes the file.
NOTE
     The NOHIDE_OPT  option is specific to IRIX.

     To compile and link a program that calls these routines, follow the
     procedures for section (3Y) routines as described in intro(3).

FILES
     /etc/exports
     /etc/xtab

SEE ALSO
     exportfs(1M), exports(4).

DIAGNOSTICS
     NULL pointer (0) returned on EOF or error.

BUGS
     The returned exportent structure points to static information that is
     overwritten in each call.