unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



sysfs(2)							     sysfs(2)



NAME

  sysfs	- gather information about file	system types

SYNOPSIS

  #include <&lt;sys/fstyp.h>&gt;
  #include <&lt;sys/fsid.h>&gt;

  int sysfs(
	  int opcode,
	  const	char *fsname );

  int sysfs(
	  int opcode,
	  int fs_index,
	  char *buf );

  int sysfs(
	  int opcode );

PARAMETERS

  buf Points to	the buffer where the file system type is placed.  The buffer
      size must	be equal to FSTYPSZ as defined in <&lt;sys/fstyp.h>&gt;.

  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.