NOMBRE

       getmntent,  setmntent,  addmntent, endmntent, hasmntopt - obtienen una entrada del fichero
       que describe los sistemas de ficheros

SINOPSIS

       #include <stdio.h>
       #include <mntent.h>

       FILE *setmntent(const char *nombrefich, const char *tipo);

       struct mntent *getmntent(FILE *pf);

       int addmntent(FILE *pf, const struct mntent *mnt);

       int endmntent(FILE *pf);

       char *hasmntopt(const struct mntent *mnt, const char *opc);

DESCRIPCIÓN

       Estas rutinas se emplean para acceder al fichero que describe los  sistemas  de  ficheros,
       /etc/fstab, y el que describe los sistemas de ficheros que están montados, /etc/mtab.

       La función setmntent() abre el fichero de descripción de sistemas de ficheros, nombrefich,
       y devuelve un puntero a FILE que puede ser usado por getmntent().  El argumento tipo es el
       tipo  de  acceso  requerido  y  puede  tomar  los  mismos valores que el argumento modo de
       fopen(3).

       La función getmntent() lee la siguiente línea del fichero de descripción  de  sistemas  de
       ficheros, pf, y devuelve un puntero a una estructura que contiene los campos descompuestos
       de una línea del fichero. El  puntero  apunta  a  un  área  estática  de  memoria  que  es
       sobreescrita en subsecuentes llamadas a getmntent().

       La función addmntent() añade la estructura mntent mnt al final del fichero abierto pf.

       La función endmntent() cierra el fichero de descripción de sistemas de ficheros pf.

       La  función  hasmntopt()  escudriña  el  campo  mnt_opts  (ver más abajo) de la estructura
       mntent mnt buscando una subcadena que concuerde con opc.  Vea <mntent.h> para opciones  de
       montaje válidas.

       La estructura mntent se define en <mntent.h> como sigue:

              struct mntent {
                      char    *mnt_fsname;    /* nombre del s.f. montado */
                      char    *mnt_dir;       /* prefijo del camino del s.f. */
                      char    *mnt_type;      /* tipo de montaje (vea mntent.h) */
                      char    *mnt_opts;      /* opciones de montaje (vea mntent.h) */
                      int     mnt_freq;       /* frecuencia de volcado (días) */
                      int     mnt_passno;     /* Nº de pasada en fsck paralelo */
              };

VALOR DEVUELTO

       La función getmntent() devuelve un puntero a la estructura mntent o NULL si falla.

       La función addmntent() devuelve 0 si acaba bien y 1 si acaba mal.

       La función endmntent() siempre devuelve 1.

       La  función hasmntopt() devuelve la dirección de la cadena si se encuentra, y NULL en otro
       caso.

FICHEROS

       /etc/fstab          descripción de sistemas de ficheros
       /etc/mtab           descripción de sistemas de ficheros montados

CONFORME A

       SunOS 4.1.3

OBSERVACIONES

       SysV incluye también una función getmntent(), pero la secuencia de llamada es  distinta  y
       la  estructura  devuelta  diferente.  Bajo SysV se utiliza /etc/mnttab.  BSD 4.4 y Digital
       Unix tienen una rutina getmntinfo(), que es una  envoltura  para  la  llamada  al  sistema
       getfsstat().

VÉASE TAMBIÉN

       fopen(3), fstab(5)

                                          17 junio 1993                              GETMNTENT(3)