[unix-history] / usr / man / man5 / tp.5

.TH TP 5 
.SH NAME
tp \- DEC/mag tape formats
.SH DESCRIPTION
The
command
.I tp
dumps files to and extracts files from
DECtape and magtape.
The formats of these tapes are the same except
that magtapes have larger directories.
.PP
Block zero contains a
copy of a stand-alone bootstrap program.
See
.IR bproc (8).
.PP
Blocks 1 through 24
for DECtape (1 through 62 for magtape)
contain a directory of the tape.
There are 192 (resp. 496) entries in the directory;
8 entries per block;
64 bytes per entry.
Each entry has the following format:
.nf
.IP ""
struct {
	char	pathname[32];
	unsigned short	mode;
	char	uid;
	char	gid;
	char	unused1;
	char	size[3];
	long	modtime;
	unsigned short	tapeaddr;
	char	unused2[16];
	unsigned short	checksum;
};
.fi
.PP
The path name entry is the path name of the
file when put on the tape.
If the pathname starts with a zero word,
the entry is empty.
It is at most 32 bytes long and ends in a null byte.
Mode, uid, gid, size and time modified
are the same as described under i-nodes 
(see file system
.IR filsys (5)).
The tape address is the tape block number of the start of
the contents of the file.
Every file
starts on a block boundary.
The file occupies (size+511)/512 blocks
of continuous tape.
The checksum entry has a value such that
the sum of the 32 words of the directory entry is zero.
.PP
Blocks above 25 (resp. 63) are available for file storage.
.PP
A fake entry
has a size of zero.
.SH "SEE ALSO"
filsys(5), tp(1)
.SH BUGS
The
.I pathname, uid, gid,
and
.I size
fields are too small.
Commit	Line	Data
099edc24 BJ	1	.TH TP 5
	2	.SH NAME
	3	tp \- DEC/mag tape formats
	4	.SH DESCRIPTION
	5	The
	6	command
	7	.I tp
	8	dumps files to and extracts files from
	9	DECtape and magtape.
	10	The formats of these tapes are the same except
	11	that magtapes have larger directories.
	12	.PP
	13	Block zero contains a
	14	copy of a stand-alone bootstrap program.
	15	See
	16	.IR bproc (8).
	17	.PP
	18	Blocks 1 through 24
	19	for DECtape (1 through 62 for magtape)
	20	contain a directory of the tape.
	21	There are 192 (resp. 496) entries in the directory;
	22	8 entries per block;
	23	64 bytes per entry.
	24	Each entry has the following format:
	25	.nf
	26	.IP ""
	27	struct {
	28	char pathname[32];
	29	unsigned short mode;
	30	char uid;
	31	char gid;
	32	char unused1;
	33	char size[3];
	34	long modtime;
	35	unsigned short tapeaddr;
	36	char unused2[16];
	37	unsigned short checksum;
	38	};
	39	.fi
	40	.PP
	41	The path name entry is the path name of the
	42	file when put on the tape.
	43	If the pathname starts with a zero word,
	44	the entry is empty.
	45	It is at most 32 bytes long and ends in a null byte.
	46	Mode, uid, gid, size and time modified
	47	are the same as described under i-nodes
	48	(see file system
	49	.IR filsys (5)).
	50	The tape address is the tape block number of the start of
	51	the contents of the file.
	52	Every file
	53	starts on a block boundary.
	54	The file occupies (size+511)/512 blocks
	55	of continuous tape.
	56	The checksum entry has a value such that
	57	the sum of the 32 words of the directory entry is zero.
	58	.PP
	59	Blocks above 25 (resp. 63) are available for file storage.
	60	.PP
	61	A fake entry
	62	has a size of zero.
	63	.SH "SEE ALSO"
	64	filsys(5), tp(1)
65	.SH BUGS
66	The
67	.I pathname, uid, gid,
68	and
69	.I size
70	fields are too small.