tmssa Special File
Purpose
To provide access to the SSA tmssa device driver.
Description
The Serial Storage Architecture (SSA) target-mode device driver provides an interface
that allows the SSA interface to be used for data transfer from using system to using
system.
You can access the data transfer functions through character special files that are
named dev/tmssann.xx, where nn is the node number of the node with which you are
communicating. The xx can be either im (initiator-mode interface), or tm (target-mode
interface). The caller uses the initiator-mode to transmit data, and the target-mode
interface to receive data.
The least significant bit of the minor device number indicates to the device driver which
mode interface is selected by the caller. When the least significant bit of the minor
device number is set to 1, the target-mode interface is selected. When the least
significant bit is set to 0, the initiator-mode interface is selected. For example,
tmssa1.im should be defined as an even-numbered minor device number to select the
initiator-mode interface. tmssa1.tm should be defined as an odd-numbered minor
device number to select the target-mode interface.
When the caller opens the initiator-mode special file, a logical path is set up. This path
allows data to be transmitted. The user-mode caller issues a write, writev, writex, or
writevx system call to start data transmission. The kernel-mode user issues an
fp_write or fp_rwuio service call to start data transmission. The SSA target-mode
device driver then builds a send command to describe the transfer, and the data is sent
to the device. The transfer can be done as a blocking write operation or as a
nonblocking write operation. When the write entry point returns, the calling program can
access the transmit buffer.
When the caller opens the target-mode special file, a logical path is set up. This path
allows data to be received. The user-mode caller issues a read, readv, readx, or
readvx system call to start the receiving of data. The kernel-mode caller issues an
fp_read or fp_rwuio service call to start the receiving of data. The SSA target-mode
device driver then returns data that was received for the application program.
Implementation Specifics
The SSA tmssa device driver provides further information about implementation
specifics. The tmssa special file is part of Base Operating System (BOS) Runtime. This
file is in the device.ssa.tm.rte file set, which is in the devices.ssa.tm package.
Related Information
The close subroutine, open subroutine, read or readx subroutine, and write or writex.
304
User’s Guide and Maintenance Information
Summary of Contents for Advanced SerialRAID Adapters SA33-3285-02
Page 1: ...Advanced SerialRAID Adapters User s Guide and Maintenance Information SA33 3285 02 ...
Page 2: ......
Page 3: ...Advanced SerialRAID Adapters User s Guide and Maintenance Information SA33 3285 02 ...
Page 16: ...xiv User s Guide and Maintenance Information ...
Page 18: ...xvi User s Guide and Maintenance Information ...
Page 21: ...Part 1 User Information 1 ...
Page 22: ...2 User s Guide and Maintenance Information ...
Page 48: ...28 User s Guide and Maintenance Information ...
Page 64: ...44 User s Guide and Maintenance Information ...
Page 76: ...56 User s Guide and Maintenance Information ...
Page 212: ...192 User s Guide and Maintenance Information ...
Page 228: ...208 User s Guide and Maintenance Information ...
Page 230: ...210 User s Guide and Maintenance Information ...
Page 254: ...234 User s Guide and Maintenance Information ...
Page 274: ...254 User s Guide and Maintenance Information ...
Page 330: ...310 User s Guide and Maintenance Information ...
Page 331: ...Part 2 Maintenance Information 311 ...
Page 332: ...312 User s Guide and Maintenance Information ...
Page 338: ...318 User s Guide and Maintenance Information ...
Page 430: ...410 User s Guide and Maintenance Information ...
Page 503: ...Part 3 Appendixes 483 ...
Page 504: ...484 User s Guide and Maintenance Information ...
Page 508: ...488 User s Guide and Maintenance Information ...
Page 529: ......
Page 530: ...Part Number 27H0678 Printed in the U S A SA33 3285 02 1P P N 27H0678 ...
Page 531: ...Spine information Advanced SerialRAID Adapters User s Guide and Maintenance Information ...