sysfs(2)                       DG/UX R4.11MU05                      sysfs(2)


NAME
       sysfs - returns information about file system types

SYNOPSIS
       #include <sys/fstyp.h>
       #include <sys/fsid.h>

       int  sysfs (int opcode, parameter1, parameter2)

   where:
       opcode      The operation code to get file system information
                   (GETFSIND, GETFSTYP, or GETNFSTYP)

       parameter1  Parameter's existence and use depends on operation.

       parameter2  Parameter's existence and use depends on operation.

DESCRIPTION
       Sysfs returns information about the file system types configured in
       the system.  The number of arguments accepted by sysfs varies and
       depends on the opcode selected.  The recognized opcodes and their
       functions are described below:

       GETFSIND  Translates fsname (parameter1), a null-terminated file
                 system identifier, into a file system type index.
                 Parameter2 is ignored.

       GETFSTYP  Translates fsindex (parameter1), a file system type index
                 into a null-terminated file system identifier and writes it
                 into the buffer pointed to by fsname (parameter2).  This
                 must be at least the size of FSTYPSZ as defined in
                 <sys/fstyp.h>.

       GETNFSTYP Returns the total number of file system types configured
                 with the system.  Parameter1 and parameter2 are ignored.

ACCESS CONTROL
       None.

RETURN VALUE
       For GETFSIND:

       fsindex or -1
              Errno is set to indicate the error if -1.  Otherwise, it is
              the type index of the file system.

       For GETFSTYP:

       0      Successful, paramater2 is set to the file system name.

       -1     An error occurred.  Errno is set appropriately.

       For GETNFSTYP:

       Number of registered file systems
              The return value indicates the number of configured file
              systems.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EINVAL    Fsname points to an invalid file system identifier;
                 fs_index is zero, or invalid; the opcode is invalid.

       EFAULT    A pathname does not completely reside in the process's
                 address space or the pathname does not terminate in the
                 process's address space.

SEE ALSO
       mount(2), nfsmount(2), fs(4).


Licensed material--property of copyright holder(s)