NAME

sam_setfa - Sets attributes on a file or directory

SYNOPSIS

cc [ flag … ] file … -L∕opt∕SUNWsamfs∕lib -lsamrpc [ -lnsl ] [ library … ]

#include "∕opt∕SUNWsamfs∕include∕samrpc.h"

int sam_setfa(const char * path , const char * ops );

The -lnsl is needed after the -lsamrpc when building on Solaris systems.

DESCRIPTION

This is the RPC-based version of sam_setfa (3x), which allows file attributes to be set from a remote machine.

sam_setfa (3x) sets attributes on a file or directory by sending its request to the StorageTek QFS or Oracle HSM server, sam-rpcd.

A call to sam_initrpc (3x) must be issued before calling this routine.

RETURN VALUES

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error.

ERRORS

EDESTADDRREQ

sam_initrpc was not successfully called, as required, before making this call.

EINVAL

A valid filename was not provided.

EPERM

The calling process is not superuser or the owner of the file specified.

EROFS

The file system is a read-only file system.

SEE ALSO

setfa (1).

sam_setfa (3x).

sam_initrpc (3x), sam_closerpc (3x).