Skip Headers
Oracle Hierarchical Storage Manager and QFS Software Command Reference
Section 3x: Introduction to Library Functions
Release 6.1.1
E70305-03

NAME

sam_release - Sets release 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_release(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_release (3x), which allows release attributes to be set from a remote machine.

sam_release (3x) sets release 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

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

SEE ALSO

release (1).

sam_release (3x).

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