File System Type Identification Library Functions
                                               fstypinit(3FSTYP)



NAME
     fstypinit, fstypfini - initialize  and  finalize  libfstyp
     handle

SYNOPSIS
     cc [ flag... ] file... -lfstyp  -lnvpair  [ library... ]
     #include 
     #include 

     int fstypinit(int fd, off64t **offset, char *moduledir,
          fstyphandlet *handle);


     void fstypfini(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.


     moduledir    Optional location of the libfstyp modules.


     handle        Opaque handle to be used with  libfstyp  func-
                   tions.


DESCRIPTION
     The fstypinit() function returns a handle  associated  with
     the  specified  parameters.  This handle should be used with
     all other libfstyp functions.


     If moduledir is NUL, fstypinit() looks for modules in the
     default    location:    /usr/lib/fs    subdirectories.   The
     fstypinit() function locates libfstyp  modules,  but  might
     defer loading the modules until the subsequent fstypident()
     call.


     If moduledir is other than NUL, the fstypinit()  function
     locates  a  module in the directory that is specified. If no
     module     is     found,     fstypinit      fails      with
     FSTYPERMODNOTFOUND.




SunOS 5.11          Last change: 20 Jun 2006                    1






File System Type Identification Library Functions
                                               fstypinit(3FSTYP)



     Modules  that  do  not  support  non-zero  offset  can  fail
     fstypinit() with FSTYPEROFSET.


     The fstypfini() function releases all resources  associated
     with a handle and invalidates the handle.

RETURN VALUES
     The fstypinit() function returns 0 on success and an  error
     value on failure. See fstypstrerror(3FSTYP).

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     fstypident(3FSTYP),                 fstypmodinit(3FSTYP),
     fstypstrerror(3FSTYP), libfstyp(3LIB), attributes(5)

























SunOS 5.11          Last change: 20 Jun 2006                    2






File System Type Identification Library Functions
                                               fstypinit(3FSTYP)






















































SunOS 5.11          Last change: 20 Jun 2006                    3