NAME

sam_segment - Sets segment 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_segment(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_segment (3x), which allows file attributes to be set from a remote machine.

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

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.

SEE ALSO

segment (1).

sam_segment (3x).

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