NAME

sysfs − gather information about file system types

SYNOPSIS

#include <sys/fstyp.h>
#include <sys/fsid.h> int sysfs(
        int opcode,
        const char ∗fsname ); int sysfs(
        int opcode,
        int fs_index,
        char ∗buf ); int sysfs(
        int opcode );

PARAMETERS

bufPoints to the buffer where the file system type is placed.  The buffer size must be equal to FSTYPSZ as defined in <sys/fstyp.h>. 

fs_index
Specifies an index file system type.

fsname
Specifies a null-terminated file system type identifier.

opcode
Specifies an operation used to obtain information about the file system types.

DESCRIPTION

This function gathers information about configured file system types.  Depending on the operation you want to perform, the opcode parameter may be specified by itself, or in combination with the other available parameters as shown in the SYNOPSIS section. 

The opcode parameter may be one of the following:

GETFSIND
Must be specified with the fsname parameter.  This operation changes the specified null-terminated file system type identifier to a file system type identifier. 

GETFSTYP
Must be specified with the parameters fs_index and buf. This operation changes the specified file system type index to a null-terminated type file system type identifier and writes it into the buffer specified. 

GETNFSTYP
Specified by itself, this operation requests the total number of file system types configured in the system to be returned.

RETURN VALUES

The following values are returned on success:

       •If GETFSIND is specified, the file system type index is returned. 

       •If GETFSTYP is specified, a value of zero (0) is returned. 

       •If GETNFSTYP is specified, the number of file system types configured in the system is returned. 

On error, a value of -1 is returned and errno is set. 

ERRORS

One or more of the following may be returned on failure:

[EINVAL]
Indicates an invalid file system identifier is pointed to fsname, the specified fs_index is either zero (0) or invalid, or the specified opcode is invalid. 

[EFAULT]
Indicates that either fsname or buf is pointing to an invalid user address. 

[ENOSYS]
Indicates that a file system was installed with a name that exceeds the buffer size of FSTYPSZ.