read_vtoc(3X)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | BUGS

NAME

read_vtoc, write_vtoc- read and write a disk's VTOC

SYNOPSIS

#include <sys/vtoc.h>
cc [ flag ... ] file ... -ladm [ library ... ]

int read_vtoc(int fd, struct vtoc *vtoc);
int write_vtoc(int fd, struct vtoc *vtoc);

DESCRIPTION

read_vtoc() returns the VTOC (volume table of contents) structure that is stored on the disk associated with the open file descriptor fd.

write_vtoc() stores the VTOC structure on the disk associated with the open file descriptor fd.

fd refers to any slice on a raw disk.

RETURN VALUES

read_vtoc returns:

positive number

Success. The positive number is the slice index associated with the open file descriptor.

negative number

There are two possible error returns. VT_EIO indicates an I/O error occurred and VT_ERROR indicates an unknown error.

write_vtoc returns:

0

Success

negative number

There are three possible error returns. VT_EIO indicates an I/O error occurred, VT_ERROR indicates an unknown error, and VT_EINVAL indicates an incorrect field within the VTOC.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	Unsafe

SEE ALSO

fmthard(1M), format(1M), prtvtoc(1M), ioctl(2), attributes(5), dkio(7I)

BUGS

write_vtoc cannot write a VTOC on an unlabeled disk. Use format(1M) for this purpose.

SunOS 5.7  Last Revised 31 Dec 1996

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | BUGS