Index for Section 3

Alphabetical listing for A

Bottom of page

advfs_set_file_attributes(3)
NAME
  advfs_set_file_attributes - Set AdvFS file attributes

SYNOPSIS
  #include <sys/advfs_syscalls.h>

  int advfs_set_file_attributes(
	  int fd,
	  fileAttributesT *fileAttributes );

LIBRARY
  AdvFS Library (libadvfs)

PARAMETERS
  fd  An open file descriptor of the file for which you want attributes set.

  *fileAttributes
      A pointer to a structure that contains the file attributes.

DESCRIPTION
  This function sets a file's AdvFS-specific attributes to the attributes
  that are defined in the specified fileAttributes structure.  However, the
  function does not set any attributes that are marked as reserved in the
  fileAttributes structure.

RESTRICTIONS
  If the stripe.segmentCnt field is set to a value greater than the total
  number of volumes in the AdvFS file domain, an error is returned.

  You must have the AdvFS Advanced Utilities license to set a file's mapType
  to XMT_STRIPE.

RETURN VALUES
  The  function returns a value of 0 (zero) on successful completion.  The
  function returns a value of -1 on failure and sets the value of errno to
  the specific error.

ERRORS
  The function sets errno to the specified errors for the following failure
  conditions:

  [EBADF]
      The file descriptor fd is not pointing to a file that resides in an
      AdvFS fileset.

  [EIO]
      An I/O error occurred on one of the disks containing the file.

  [EINVAL]
      The fileAttributes.writeOrder field contains a value other than
      ADVFS_WO_ASYNC_WRITE, ADVFS_WO_DATA_LOGGING, or ADVFS_WO_SYNC_WRITE.

      The fileAttributes.mapType field contains a value other than XMT_SIMPLE
      or XMT_STRIPE.

      The fileAttributes.mapType field is set to XMT_STRIPE and the
      fileAttributes.stripe.segmentCnt field contains a value less than 2 or
      greater than the number of volumes in the domain.

  [ENOMEM]
      There is not enough memory available for the operation.

SEE ALSO
  Commands: chfile(8), showfile(8), stripe(8)

  Functions: open(2), advfs_get_file_attributes(3)

Index for Section 3

Alphabetical listing for A

Top of page