PIP(8) PIP(8)
NAME
pip - CD-ROM workbench
SYNOPSIS
disk/pip
DESCRIPTION
Pip is a SCSI I/O program centered around a SCSI disk of
files called tracks. Various commands will load and store
tracks from and to various CD-ROM readers, writers, and
files. Pip was written to be run on a stand-alone worksta-
tion so that the I/O data rates required for CD-audio can be
sustained.
When pip starts, it probes the SCSI bus and looks for one of
the following disks. The table in the program should be
extended to include your favorite disk. The program does
not recognize just any disk because it might scribble on
precious data.
SEAGATE ST42400N
SEAGATE ST41520N
SEAGATE ST410800N
Pip looks for the following device for the CD ROM writer.
IMS CDD521/10
Pip looks for one of the following devices for the CD ROM
reader. The Philips will not read cdda format and the NEC
does not work well with pip. The Toshiba does not accurately
seek on cdda media. We recommend the Plextor. The first
column is the device name that should be given in the inter-
active commands.
plex PLEXTOR CD-ROM PX-4XCS
tosh TOSHIBA CD-ROM DRIVE:XM
phil IMS CDD521/10
nec NEC CD-ROM DRIVE:5001.0
nec NEC CD-ROM DRIVE:8411.0
The following commands are recognized.
help Print a one line description of each command.
load device track format disktrack
A track is copied from the device to the des-
ignated track on the disk. The track is a
number or *, designating all tracks. If the
copy completes normally, the old data on that
disk track is lost. format is either cdda or
cdrom.
verif device track format disktrack
This is the same as load except that the data
is not copied, but compared to the data on the
disk. The compare allows a slip of multiples
Page 1 Plan 9 (printed 10/30/25)
PIP(8) PIP(8)
of four bytes as might occur copying an audio
CD with imprecise seek.
store track file
The disk track is written to a regular Plan 9
file. The track may be a number or *. If the
track is *, then the string file is prefixed
to the track number for every track.
toc [device] Will print the table of contents of the speci-
fied device. If no device is given, then the
track table of contents of the disk is given.
cleartoc All tracks on the disk are deleted.
remove track The specified track on the disk is deleted.
sum track The specified disk track is read and check-
summed.
publish track The specified disk track is copied to the next
track on the Philips CD writer. The format of
the data is not specified until the table of
contents is written. Although it is not
required, it is usual that all tracks are the
same format.
fixate format Issue a fixate command to the Philips CD
writer. Format is either cdda or cdrom. This
makes the table of contents permanent.
session format
Issue a session command to the Philips CD
writer. This is the same as fixate except
that a second session is opened and more data
may be put on the CD. Most readers can only
see the table of contents from the first ses-
sion.
9660 proto track
A filesystem description is read from the
proto file in mkfs(8) format. The file system
is converted to ISO 9660 format and written on
the specified disk track.
The first line of the proto file for the 9660 command is
parsed for options. The following options are recognized.
-c Convert all file names in the file system so that
they conform to 9660 standards. (Roughly this is
eight or fewer single case alphanumerics followed
by an optional period and three or fewer single
case alphanumerics.) File names that conform are
converted from lower case letters in the input file
system to upper case in the output file system.
Names that do not conform are renamed to Fnumber
and directories are renamed Dnumber. A file named
_CONFORM.MAP is created in the root of the output
file system with old-name new-name pairs of all
converted files.
-e Add a system-use field to every directory record
that contains the name, uid, gid, and mode of the
file. With or without this extension, directory
Page 2 Plan 9 (printed 10/30/25)
PIP(8) PIP(8)
records conform to the 9660 standard and should be
able to be read on other systems.
-a file Places the named file in the abstract field of the
primary volume descriptor. The file must be in the
root directory.
-b file Places the named file in the bibliographic field of
the primary volume descriptor. The file must be in
the root directory.
-n file Places the named file in the copyright field of the
primary volume descriptor. The file must be in the
root directory.
-s dir Prefix the directory name dir to the names of files
in the proto file. This permits a file tree to be
assembled cleanly under a special directory, to be
then copied into the new file system at the root.
-v Print each file name as it is copied.
All dates in the output file system are set to the date the
command was executed. The volume identifier field of the
primary volume descriptor is set to the last component of
the proto file name. The system identifier field of the
primary volume descriptor is set to PLAN 9, and should be
keyed to the interpretation of the system-use fields of the
directory records.
Example
To cut your own audio CD with your favorite CDs:
cleartoc
load plex 5 cdda 1 # read track 5 from an audio CD
load plex 2 cdda 2 # read track 2 from an audio CD
load ... # etc.
publish * # write all tracks to Philips CD writer
fixate cdda # write table of contents
To cut your own 9660 CD-ROM:
mount /srv/bootes /n/bootes # make a clean, bind-free tree
9660 mkfs 4 # make a 9660 image from a mkfs specification
# for the Plan 9 distribution
# the first line of mkfs is
# -s /n/bootes -c -e -n notice
publish 4 # write 9660 image to Philips CD writer
fixate cdrom # write table of contents
SOURCE
/sys/src/cmd/disk/pip
SEE ALSO
mkfs(8)
BUGS
Page 3 Plan 9 (printed 10/30/25)
PIP(8) PIP(8)
The program only knows about a few devices. The tables and
device code must be extended to be more comprehensive. The
industry has not adopted a standard way to read and write
audio.
Page 4 Plan 9 (printed 10/30/25)