NAME

sam_stage - Sets stage attributes on a file

SYNOPSIS

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

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

int sam_stage(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_stage (3x), which allows stage attributes on a file to be set from a remote machine.

sam_stage (3x) sets stage attributes on a file or directory by sending its request to the StorageTek QFS or Oracle HSM RPC 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

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

SEE ALSO

stage (1).

sam-stagealld (1m).

sam_stage (3x).

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