.fp 5 CW

.de Af

.ds ;G \\*(;G\\f\\$1\\$3\\f\\$2

.if !?\\$4?? .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"

..

.de aF

.ie ?\\$3?? .ft \\$1

.el \{\

.ds ;G \&

.nr ;G \\n(.f

.Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"

\\*(;G

.ft \\n(;G \}

..

.de L

.aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"

..

.de LR

.aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"

..

.de RL

.aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"

..

.de EX		\" start example

.ta 1i 2i 3i 4i 5i 6i

.PP

.RS 

.PD 0

.ft 5

.nf

..

.de EE		\" end example

.fi

.ft

.PD

.RE

.PP

..

.TH STRTAPE 3

.SH NAME

strtape \- convert string to tape device pathname

.SH SYNOPSIS

.L "char* strtape(char* s, char** e)"

.SH DESCRIPTION

.I strtape

converts the generic tape device specification in the nul-terminated string

.I s

to a local tape device pathname.

A pointer to the device pathname is returned.

If 

.I e

not 0 then

.I *e

is set to point to the first unrecognized character in

.IR s .

.PP

A tape device specification is composed of

.IR unit-density-rewind .

All are optional.

.I unit

is a unit number in the range

.BR [0-7] .

The default unit is

.BR 1 .

Density may be one of:

.TP 3

.B l

for low;

.TP 3

.B m

for medium, and

.TP

.B h

for high.

.PP

The default is

.BR m .

.I rewind

is

.B n

for no-rewind on device close.

The default is to rewind on device close.

.SH "SEE ALSO"

pax(1), tar(1)

.SH CAVEATS

The return value points to a static area that is overwritten on each call.