User Tools

Site Tools


solaris:fstyp_init.3fstyp

fstyp_init


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(fstyp_handle_t 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:

SEE ALSO

fstyp_ident(3FSTYP), fstyp_mod_init(3FSTYP), fstyp_strerror(3FSTYP), libfstyp(3LIB), attributes(7)


solaris/fstyp_init.3fstyp.txt · Last modified: 2023/07/19 08:58 by A User Not Logged in