*** UNIX MANUAL PAGE BROWSER ***

scu(8) System Manager's Manual scu(8) NAME scu - SCSI CAM Utility Program SYNOPSIS /sbin/scu [ -options... ] [ command [ keywords... ]] DESCRIPTION The SCSI utility program, scu, interfaces with the CAM I/O subsystem and the peripherals attached to the SCSI buses. Use this program to maintain and diagnose problems with SCSI peripherals and the CAM I/O subsystem. The scu utility program has an extensive help feature. Log in as root and enter /sbin/scu help at the command prompt to view the help overview and en- ter a ? at the topic> prompt to view a list of the utility's commands and conventions. The file /sbin/scu.hlp contains the help information used in the help feature. OPTIONS Specifies the user agent path. Specify the raw device pathname. You must specify a character device special file, for example, /dev/rrz3c. If the device name is not specified on the command line, the program checks the environment variable SCU_DEVICE to define the device name. Do not execute a startup script. Enable pipe operation mode. Specify a script startup file name. COMMANDS The following table summarizes the scu commands and their functions. Refer to the help command for complete syntax and examples of use. tab(@); lfHB lfHB lw(1.0i) lw(3.50i) . _ Command@Function _ allow@Allows media removal from a device change@Changes mode pages for a device download@Downloads microcode to a device dump@Dumps data from a device eject@Stops a CD-ROM and then ejects its caddy erase@Performs erase operations on a device exit@T{ Exit the scu program. Ctrl/d can be used in interactive opera- tion. An alias for exit is quit. T} evaluate@Evaluates an expression format@Formats disk media help@Displays help on scu command elements mbad@Produces hard and soft errors on disks mt@Issues one of the supported magnetic tape commands onerror@Controls program actions when an error occurs pause@Pauses playing a CD-ROM audio disk play@Plays tracks on a CD-ROM audio disk prevent@Prevents removal of media from a device read@Performs read operations on a device reassign@Reassigns a defective block on a disk device release@Releases a reserved device or a frozen SIM queue repeat@Defines a repeat count for a series of commands reserve@Reserves a device for exclusive use resume@Resumes playing a paused CD-ROM audio disk reset@Resets a bus or device rezero@Issues a CAM Bus Reset CCB command scan@T{ Scans device media or the CAM Equipment Device Table (EDT) T} seek@Seeks a logical block address set@T{ Sets parameters for a device or the scu program T} shell@Exits to shell program until you exit the shell show@T{ Displays parameters for a device or the scu program T} sleep@T{ Specifies the time the scu program is to sleep T} source@Sources input from an external command file start@Starts a unit that is stopped stop@Stops a unit switch@Switches to another device system@Passes one system command to the shell program test@Performs tests on a controller time@Times command sequences tur@Issues a Test Unit Ready command to a device usleep@T{ Specifies the time the scu program is to sleep (in microsec- onds). T} verify@Performs verify operations on a device write@Performs write operations on a device xza@Performs operations on the KZMSA controller zero@Zeros device or scu program parameters _ RESTRICTIONS Commands that modify device data or device parameters require write ac- cess to the device entry. Applications that change the volume level of the CDROM must open the device for write access since a SCSI Mode Se- lect command is used to modify the volume level. EXAMPLES To format an RX26 diskette at extra density, enter: scu> format density ED To verify 1024 blocks starting at block 1000, enter: scu> verify media starting 1000 length 1024 To display all changeable mode pages for a device, enter: scu> show page pcf changeable To display inquiry information for all devices on the first SCSI bus at lun 0 in the Equipment Device Table (EDT), enter: scu> show edt bus 0 lun 0 full RETURN VALUES For all commands, scu runs and exits with 0 for success, 1 for warning, or -1 for failure status. ERRORS When a SCSI device error occurs, both the sense key and the addition sense code or qualifier are decoded and displayed as follows: scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parame- ter, Sense Code/Qualifier = (0x20, 0) = Invalid command operation code This error indicates that you have issued a command that is not sup- ported by the selected device. This can happen for optional commands that are not supported by all devices. FILES The SCSI Utility executable file. The device entry for the CAM User Agent driver. Contains the scu help information. RELATED INFORMATION Commands: file(1), more(1). Functions: open(2), close(2), ioctl(2), fopen(3), fgets(3), fputs(3), popen(3), pclose(3), malloc(3), printf(3), fprintf(3). American National Standard for Information Systems, Small Computer Sys- tems Interface - 2 (SCSI - 2), X3.131-199X American National Standard for Information Systems, SCSI-2 Common Ac- cess Method: Transport and SCSI Interface Module, working draft, X3T9.2/90-186 delim off scu(8)