Home       Linux       Windows       Dos       Mac

Last updated Saturday, December 7, 2002 by p.lavarre@ieee.org.

PLScsi Syntax

We say the syntax of a SCSI command line is:

plscsi [-$option...] [$name...] [// $comment...]

We present examples in our essay titled Why Bother With PLScsi. Commonly, the first command issued is:

plscsi -w

`plscsi -h` will remind you of all the options we offer. To let you talk SCSI, we define:

-w		--whichever		list the well-known path names now connected to SCSI devices
-h		--help		say much, but less than all, of what you see here
-x		--x $cdb		specify a specific Cdb in hex
-i		--in $length		ask to copy In from the device at most a length of bytes
-o		--out $length		ask to copy Out to the device at most a length of bytes
-a		--align $page $offset		mis/align the data to a $page size by an $offset in bytes
-d		--data $length		allot & trace more than just the --in or --out $length of data

If possible, to let you decide more of the command, we define:

		-X sense $length		limit the count of sense bytes copied In
		-X time $s $ns		limit the seconds & nanoseconds spent talking

When a merely conventional shell is your scripting engine, we also define:

-v		--verbose		trace more to stderr
-q		--quiet		trace less to stderr
-p		--please		allow -x 04 Format, unusual Cdb lengths, etc.
-f		--from $fileName		copy the data Out to the device from $fileName ("" means stdin)
-l		--loop		talk to an imaginary loopback device
-t		--to $fileName		copy the data In from the device to the $fileName ("" means stdout)
-c		--compare		compare data supposedly copied Out with the data copied In
-y		--yes		repeat while not ok, until ok
-n		--no		repeat while ok, until not ok

Always, we let you ask for a specific form of transport:

		-X aspi		talk only thru Microsoft Windows ASPI
		-X dos		talk only thru Microsoft DOS ASPI
		-X sgio		talk only thru Linux ioctl SG_IO
		-X spt		talk only thru Windows DeviceIoControl IOCTL_SCSI_PASS_THROUGH
		-X sptd		talk only thru Windows DeviceIoControl IOCTL_SCSI_PASS_THROUGH_DIRECT
		-X sptx		talk only thru Windows DeviceIoControl, -X Spt if <= 16KiB, else -X Sptd

If possible, we define residue accurate to the byte in the exit code.

Last updated Saturday, December 7, 2002 by p.lavarre@ieee.org.

Home