File System Type Identification Library Functions
fstyp_init(3FSTYP)
NAME
fstyp_init, fstyp_fini - initialize and finalize libfstyp
handleSYNOPSIS
cc [ flag... ] file... -lfstyp -lnvpair [ library... ]
#include
#include
int fstyp_init(int fd, off64_t **offset, char *module_dir,
fstyp_handle_t *handle);
void fstyp_fini(void *handle);
PARAMETERS
fd Open file descriptor of a block or a raw dev-
ice that contains the file system to be iden-
tified. offset Offset from the beginning of the device where the file system is located.module_dir Optional location of the libfstyp modules.
handle Opaque handle to be used with libfstyp func-
tions.DESCRIPTION
The fstyp_init() function returns a handle associated with
the specified parameters. This handle should be used with all other libfstyp functions.If module_dir is NULL, fstyp_init() looks for modules in the
default location: /usr/lib/fs subdirectories. Thefstyp_init() function locates libfstyp modules, but might
defer loading the modules until the subsequent fstyp_ident()
call.If module_dir is other than NULL, the fstyp_init() function
locates a module in the directory that is specified. If nomodule is found, fstyp_init fails with
FSTYP_ERR_MOD_NOT_FOUND.
SunOS 5.11 Last change: 20 Jun 2006 1
File System Type Identification Library Functionsfstyp_init(3FSTYP)
Modules that do not support non-zero offset can fail
fstyp_init() with FSTYP_ERR_OFFSET.
The fstyp_fini() function releases all resources associated
with a handle and invalidates the handle.RETURN VALUES
The fstyp_init() function returns 0 on success and an error
value on failure. See fstyp_strerror(3FSTYP).
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | MT-Safe |
|_____________________________|_____________________________|
SEE ALSO
fstyp_ident(3FSTYP), fstyp_mod_init(3FSTYP),
fstyp_strerror(3FSTYP), libfstyp(3LIB), attributes(5)
SunOS 5.11 Last change: 20 Jun 2006 2
File System Type Identification Library Functionsfstyp_init(3FSTYP)
SunOS 5.11 Last change: 20 Jun 2006 3