media_getid man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

media_getid(3VOLMGT)  Volume Management Library Functions media_getid(3VOLMGT)

NAME
       media_getid - return the id of a piece of media

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

       #include <volmgt.h>

       ulonglong_t media_getid(char *vol_path);

DESCRIPTION
       This  function  is  obsolete.  The management of removable media by the
       Volume Management feature, including vold, has been replaced  by	 soft‐
       ware  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 unde‐
       fined.

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

PARAMETERS
       vol_path	   Path to the block or character special device.

RETURN VALUES
       The return from this function is undefined.

EXAMPLES
       Example 1 Using media_getid()

       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 (volmgt_running()) {
	      if (volmgt_ownspath(path)) {
		   (void) printf("id of %s is %lld\n",
			path, media_getid(path));
	      }
	      }

       If  a  program using media_getid() does not check whether or not volume
       management is running, then any NULL 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.

ATTRIBUTES
       See attributes(5)  for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Safe			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Obsolete			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       volmgt_ownspath(3VOLMGT),volmgt_running(3VOLMGT),attributes(5), hal(5)

SunOS 5.11			  8 Mar 2007		  media_getid(3VOLMGT)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net