NAME

sam_closecat - Closes a catalog handle

SYNOPSIS

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

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

int sam_closecat(int cat_handle );

AVAILABILITY

32-bit programs only

DESCRIPTION

sam_closecat() deallocates the catalog handle indicated by cat_handle. cat_handle is a catalog "handle" obtained from a previous call to sam_opencat(). Deallocation of the catalog handle ends access to the automated library catalog that it referred to, and makes the catalog handle available for return by subsequent calls to sam_opencat().

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

sam_closecat() fails if one or more of the following error conditions are true:

EBADFILE: cat_handle is invalid.