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

NAME

       volmgt_symname, volmgt_symdev - convert between Volume Management symbolic names, and the devices that correspond to them

SYNOPSIS

       cc [ flag ... ] file ... -lvolmgt [ library ... ]
       #include <volmgt.h>

       char *volmgt_symname(char *pathname);

       char *volmgt_symdev(char *symname);

DESCRIPTION

       These  two  routines  compliment  each other, translating between Volume Management's symbolic name for a device, called a symname, and the
       /dev pathname for that same device.

       volmgt_symname() converts a supplied /dev pathname to a symname, Volume Management's idea of that device's symbolic  name  (see	volfs(7FS)
       for a description of Volume Management symbolic names).

       volmgt_symdev() does the opposite conversion, converting between a symname, Volume Management's idea of a device's symbolic name for a vol-
       ume, to the /dev pathname for that device.

RETURN VALUES

       volmgt_symname() returns the symbolic name for the device pathname supplied, and volmgt_symdev() returns the device pathname for  the  sup-
       plied symbolic name.

       These strings are allocated upon success, and therefore must be freed by the  caller when they are no longer needed (see  free(3C)).

ERRORS

       volmgt_symname()  can  fail,  returning a null string pointer, if a stat(2) of the supplied pathname fails, or if an open(2) of /dev/volctl
       fails, or if any of the following is true:

       ENXIO	       Volume Management is not running.

       EINTR	       An interrupt signal was detected while trying to convert the supplied pathname to a symname.

       volmgt_symdev() can fail if an open(2) of /dev/volctl fails, or if any of the following is true:

       ENXIO	       Volume Management is not running.

       EINTR	       An interrupt signal was detected while trying to convert the supplied symname to a /dev pathname.

EXAMPLES

       Example 1: Testing Floppies

       The following tests how many floppies Volume Management currently sees in floppy drives (up to 10):

       for (i=0; i < 10; i++) {
	       (void) sprintf(path, "floppy%d", i);
	       if (volmgt_symdev(path) != NULL) {
		       (void) printf("volume %s is in drive %d
",
			   path, i);
	       }
       }

       Example 2: Finding The Symbolic Name

       This code finds out what symbolic name (if any) Volume Management has for /dev/rdsk/c0t6d0s2:

       if ((nm = volmgt_symname("/dev/rdsk/c0t6d0s2")) == NULL) {
	       (void) printf("path not managed
");
       } else {
	       (void) printf("path managed as %s
", nm);
       }

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       cc(1B),	vold(1M),  open(2),  stat(2),  free(3C),  malloc(3C),	volmgt_check(3VOLMGT),	 volmgt_inuse(3VOLMGT),   volmgt_running(3VOLMGT),
       attributes(5), volfs(7FS)

NOTES

       These routines only work when Volume Management is running.

BUGS

       There  should  be  a straightforward way to query Volume Management for a list  of all media types it's managing, and how many of each type
       are being managed.

SunOS 5.10							    31 Dec 1996 					   volmgt_symname(3VOLMGT)