Manual Pages for UNIX Operating System command usage for man fstyp_init

File System Type Identification Library Functions
                                               fstyp_init(3FSTYP)



NAME
     fstyp_init, fstyp_fini - initialize  and  finalize  libfstyp
     handle

SYNOPSIS
     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.   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.




SunOS 5.11          Last change: 20 Jun 2006                    1






File System Type Identification Library Functions
                                               fstyp_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 Functions
                                               fstyp_init(3FSTYP)






















































SunOS 5.11          Last change: 20 Jun 2006                    3