Volume Management Library Functions          mediagetid(3VOLMGT)



NAME
     mediagetid - return the id of a piece of media

SYNOPSIS
     cc [flag ...] file ...-lvolgmt [library ...]

     #include 



     ulonglongt mediagetid(char *volpath);


DESCRIPTION
     This function is obsolete. The management of removable media
     by  the  Volume Management feature, including vold, has been
     replaced by software that supports the Hardware  Abstraction
     Layer (HAL). Programmatic support for HAL is through the HAL
     APIs, which are documented on the HAL web site. See  hal(5).
     The return value of this function is undefined.


     mediagetid() returns the id of a  piece  of  media.  Volume
     management must be running. See volmgtrunning(3VOLMGT).

PARAMETERS
     volpath    Path to the block or character special device.


RETURN VALUES
     The return from this function is undefined.

EXAMPLES
     Example 1 Using mediagetid()


     The following example first checks if volume  management  is
     running,  then  checks  the volume management name space for
     path, and then returns the id for the piece of media.


       char *path;

            ...

       if (volmgtrunning()) {
            if (volmgtownspath(path)) {
                 (void) printf("id of %s is %lld\n",
                      path, mediagetid(path));
            }
            }




SunOS 5.11           Last change: 8 Mar 2007                    1






Volume Management Library Functions          mediagetid(3VOLMGT)



     If a program using mediagetid() does not check  whether  or
     not volume management is running, then any NUL return value
     will be ambiguous, as  it  could  mean  that  either  volume
     management  does  not have path in its name space, or volume
     management is not running.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    
     Interface Stability          Obsolete                    
    


SEE ALSO
     volmgtownspath(3VOLMGT),volmgtrunning(3VOLMGT),attributes(5),
     hal(5)






























SunOS 5.11           Last change: 8 Mar 2007                    2