NAME

sam_ssum - Sets message-digest attributes on a file over a network connection

SYNOPSIS

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

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

int sam_ssum(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_ssum (3x).

sam_ssum (3x) sets a file's message-digest and fixity attributes by sending a request to the StorageTek QFS or Oracle HSM RPC server, sam-rpcd.

If the server machine is different from the local machine, path must be an absolute path. If the server machine is the local machine, path may be an absolute path or relative to the user's current working directory.

Depending on the options and the size of the file, this operation may take longer then the default timeout value of 25 seconds. The timeout value can be changed during initialization using the sam_initrpc_timeout or anytime prior to a sam_ssum call using the sam_settimeout call.

A call to sam_initrpc (3x) or sam_initrpc_timeout (3x) must be issued before these calls.

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: path is not an absolute pathname and the server (SAMHOST) machine is not the same as the local machine.
ETIMEDOUT: The operations performed on path exceeded the RPC call timeout value.