NAME

sam_devstr - Translates numeric device status into character string

SYNOPSIS

cc [ flag … ] file … -L∕opt∕SUNWsamfs∕lib -lsam [ library … ]

#include "∕opt∕SUNWsamfs∕include∕lib.h"

char *sam_devstr(uint_t status )

DESCRIPTION

sam_devstr() translates an unsigned integer, status, into a character status string based on the bits set in status, returning a pointer to the character string.

The meanings of the characters in the string returned are as follows:

s---------

Volume is being scanned.

m---------

If a file system, the file system is mounted.

M---------

The device is in maintenance mode.

-E--------

Device received an unrecoverable error.

-a--------

Device is auditing. If a file system, it is being archived.

--l-------

Volume has a label.

---I------

Device is in wait-idle mode.

---A------

Device requires operator attention.

----U-----

Unload has been requested.

----C-----

Device needs cleaning.

-----R----

The device has been requested.

------w---

The device is open for writing.

-------o--

The device is open.

--------P-

The device is positioning (tape only).

--------F-

All storage slots are occupied (robotic devices only).

--------V-

The device is verifying media (tape only).

--------Q-

The device verify media command was canceled (tape only).

---------r

Device is ready. If a file system, its disk space is being released.

---------R

Device is ready and the volume is read-only.

---------W

Device is ready and the cartridge write-protect tab is set.

---------p

Device is present.

RETURN VALUES

A pointer to the character status string is returned.

SEE ALSO

sam_devstat (3).