Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ xy(4S) — SunOS 1.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

dkio(4S)

xy(4S)

XY(4S)  —  System Manager’s Manual — Special Files

NAME

xy − Disk driver for Xylogics SMD Disk Controllers

SYNOPSIS

controller xyc0 at mb0 csr 0xee40 priority 2
disk xy0 at xyc0 drive 0
disk xy1 at xyc0 drive 1

DESCRIPTION

Files with minor device numbers 0 through 7 refer to various portions of drive 0; minor devices 8 through 15 refer to drive 1, and so on.  The standard device names begin with “xy” followed by the drive number and then a letter a-h for partitions 0-7 respectively.  The character ? stands here for a drive number in the range 0-7. 

The block file’s access the disk via the system’s normal buffering mechanism and may be read and written without regard to physical disk records.  There is also a ‘raw’ interface which provides for direct transmission between the disk and the user’s read or write buffer.  A single read or write call results in exactly one I/O operation and therefore raw I/O is considerably more effficient when many words are transmitted.  The names of the raw files conventionally begin with an extra ‘r.’

In raw I/O counts should be a multiple of 512 bytes (a disk sector).  Likewise seek calls should specify a multiple of 512 bytes. 

DISK SUPPORT

This driver handles all SMD drives, by reading a label from sector 0 of the drive which describes the disk geometry and partitioning. 

The xy?a partition is normally used for the root file system on a disk, the xy?b partition as a paging area, and the xy?c partition for pack-pack copying (it normally maps the entire disk).  The rest of the disk is normally the xy?h partition. 

FILES

/dev/xy[0-7][a-h]block files
/dev/rxy[0-7][a-h]raw files

SEE ALSO

dkio(4S), xy(4S)
Xylogics Model 440 Peripheral Processor SMD Disk Subsystem Maintenance and Reference Manual (Sun 800-1005-01)
Xylogics Model 450 Peripheral Processor SMD Disk Subsystem Maintenance and Reference Manual (Sun 800-1025-01)

DIAGNOSTICS

xyc%d: self test error %x - %s.  Self test error in controller, see the Maintenance and Reference Manual. 

xyc%d: address mode jumper is wrong.  The controller is strapped for 24-bit Multibus addresses; the Sun uses 20-bit addresses.  See the Hardware Configuration and Expansion section of the System Manager’s Manual for your Sun Workstaiton for instructions on setting the jumpers on the 450. 

xyattach: can’t get bad sector info.  The bad sector forwarding information for the disk, which is kept on the last cylinder, could not be read. 

xy%d: drive type %d clash with xy%d.  The 450 does not support mixing the drive types found on these units on a single controller. 

xy%d: initialization failed. 

xy%d: error %x reading label on head %d.  Error reading drive geometry/partition table information. 

xy%d: Corrupt label.  The geometry/partition label checksum was incorrect. 

xy%d: Unsupported phys partition # %d. 

xy%d: offline. 

xy%d%c: cmd how (msg) blk %d.  A command such as read, write, or format encountered a error condition (how): either it failed, the unit was restored, or an operation was retry’ed.  The msg is derived from the error number given by the controller, indicating a condition such as “drive not ready”, “sector not found” or “disk write protected”. 

BUGS

In raw I/O read and write(2) truncate file offsets to 512-byte block boundaries, and write scribbles on the tail of incomplete blocks.  Thus, in programs that are likely to access raw devices, read, write and lseek(2) should always deal in 512-byte multiples.

Sun System Release 1.0  —  11 August 1983

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026