FSTYP_INIT(3FSTYP) File System Type Identification Library Functions
NAME
fstyp_init, fstyp_fini - initialize and finalize libfstyp handle
SYNOPSIS
cc [
flag... ]
file...
-lfstyp -lnvpair [
library... ]
#include <libnvpair.h>
#include <libfstyp.h>
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 device that
contains the file system to be identified.
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 functions.
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. The
fstyp_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 no module is found,
fstyp_init fails with
FSTYP_ERR_MOD_NOT_FOUND.
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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
fstyp_ident(3FSTYP),
fstyp_mod_init(3FSTYP),
fstyp_strerror(3FSTYP),
libfstyp(3LIB),
attributes(7) June 20, 2006 FSTYP_INIT(3FSTYP)
