volmgt_root man page on SmartOS

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

VOLMGT_ROOT(3VOLMGT)					  VOLMGT_ROOT(3VOLMGT)

NAME
       volmgt_root - return the volume management root directory

SYNOPSIS
       cc [ flag... ] file... -lvolmgt [ library ... ]
       #include <volmgt.h>
       const char *volmgt_root(void);

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.

       The volmgt_root() function returns the current volume  management  root
       directory,  which  by  default is /vol but can be configured to be in a
       different location.

RETURN VALUES
       The return from this function is undefined.

ERRORS
       This function may fail if an open()  of	/dev/volctl  fails.   If  this
       occurs  a  pointer  to  the default Volume Management root directory is
       returned.

EXAMPLES
       Example 1 Finding the Volume Management Root directory.

       To find out where the volume management root directory is:

	 if ((path = volmgt_root()) != NULL) {
		 (void) printf("Volume Management root dir=%s\n", path);
	 } else {
		 (void) printf("can't find Volume Management root dir\n");
	 }

FILES
       /dev
	       default location for the volume management root directory

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

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

SEE ALSO
       open(2),	 volmgt_check(3VOLMGT),	  volmgt_inuse(3VOLMGT),   volmgt_run‐
       ning(3VOLMGT), attributes(5), hal(5)

NOTES
       This  function  returns	the  default root directory location even when
       volume management is not running.

				  Mar 8, 2007		  VOLMGT_ROOT(3VOLMGT)
[top]

List of man pages available for SmartOS

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