| Skip Navigation Links | |
| Exit Print View | |
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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 cata-
log 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. Oth-
erwise, a value of -1 is returned and errno is set to indi-
cate the error.
ERRORS
sam_closecat() fails if one or more of the following error
conditions are true:
EBADFILE cat_handle is invalid.
SEE ALSO
sam_getcatalog(3), sam_opencat(3).