read_vtoc(3EXT)

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

NAME

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

SYNOPSIS

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

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

DESCRIPTION

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

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

The fd argument refers to any slice on a raw disk.

RETURN VALUES

Upon successful completion, read_vtoc() returns a positive integer indicating the slice index associated with the open file descriptor. Otherwise, it returns a negative integer indicating one of the following errors:

VT_EIO

An I/O error occurred.

VT_ENOTSUP

This operation is not supported on this disk.

VT_ERROR

An unknown error occurred.

Upon successful completion, write_vtoc() returns 0. Otherwise, it returns a negative integer indicating one of the following errors:

VT_EINVAL

The VTOC contains an incorrect field.

VT_EIO

An I/O error occurred.

VT_ENOTSUP

This operation is not supported on this disk.

VT_ERROR

An unknown error occurred.

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), efi_alloc_and_init(3EXT), attributes(5), dkio(7I)

BUGS

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

SunOS 5.9  Last Revised 25 Jul 2002

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