mc01(7) mc01(7)
NAME
mc01 - Portable Device Interface (PDI) medium changer target
driver
DESCRIPTION
The mc01 medium changer target driver is the device-level
driver for Small Computer System Interface (SCSI) medium
changers. SCSI Medium Changers mechanize the movement of
media to and from primary devices (such as disk or tape
drives) and other locations within the medium changer
(magazines).
The mccntl(1) command provides command line access to the mc01
target driver. This command allows the user to load, unload,
position, initialize device status and display the current
device status.
The special device files in the /dev/mc directory are used to
access the medium changers attached to the system. There are
two names provided for each medium changer attached to the
system. The special device files have the form:
/dev/mc/mc#
/dev/mc/cCbBtTdDlL
The name components for the /dev/mc/mc# form are:
# is the number, starting with 1, of the associated medium
changer. There is one special file of this form for
each medium changer attached to the system.
The name components for the /dev/mc/cCbBtTdDlL form are:
C is the occurrence of the host adapter board in the
system (that is, card number)
B is the bus number
T is the target controller number
D is the logical unit number of the medium changer
mc01 Device Nodes
/dev/mc:
Nodes in this directory provide access to SCSI Medium Changers
Copyright 1994 Novell, Inc. Page 1
mc01(7) mc01(7)
attached and recognized by the system.
cCbBtTlL C - Controller Number
B - SCSI Bus Number
T - SCSI Target ID
L - SCSI Logical Unit Number
mcN N - The changer number. The changers are numbered
sequentially starting at 1 as they are
found by the system.
ioctl Calls
The ioctl calls used by the mc01 driver to control the medium
changer operations are as follows:
MC_EXCHANGE
Used to exchange the currently loaded media, with media
from a specified slot. The currently loaded media is
placed back into the magazine slot from which it was
loaded. The command used to implement this ioctl is
optional, therefore this command's functionality is
medium changer dependent.
MC_INIT_STATUS
Used to initialize the medium changer's status. This
operation should be performed whenever a new magazine is
inserted, or the medium changer's front panel controls
are used to manipulate the mechanism.
MC_MOVE_MEDIUM
Used to move a medium element from one storage element
location to another.
MC_POSITION
Used to position the medium changer to a specific
storage element location. This is an optional SCSI
command. The command used to implement this ioctl is
optional, therefore this command's functionality is
medium changer dependent.
MC_ELEMENT_COUNT
Reports the number of storage element locations in the
currently loaded magazine.
Copyright 1994 Novell, Inc. Page 2
mc01(7) mc01(7)
MC_STATUS
Reports the status of the medium changer device. The
report includes the total number of storage element
locations, status (Loaded or Empty) of each storage
element location, and status (Loaded or Empty) of the
data transfer element (drive).
MC_LAST_LOADED
Reports the storage element number that the currently
loaded media came from.
MC_PREVMR
Used to prevent media/magazine removal. The command
used to implement this ioctl is optional, therefore this
command's functionality is medium changer dependent.
MC_ALLOWMR
Used to allow media/magazine removal. The command used
to implement this ioctl is optional, therefore this
command's functionality is medium changer dependent.
SDI_RESERVE
Reserves a SCSI disk for a processor.
SDI_RELEASE
Releases a SCSI disk from a processor.
B_GETTYPE
Returns the bus name (for example, scsi) and device
driver name (for example, mc01) of a specific device.
B_GETDEV
Returns the pass-through major and minor numbers to the
calling utility, allowing creation of a pass-through
special device file.
Files
/usr/include/sys/mc01.h
/usr/include/sys/sdi.h
/usr/include/sys/scsi.h
REFERENCES
ioctl(2), mccntl(1M)
Copyright 1994 Novell, Inc. Page 3