usr/src/lib/libast/common/man/strtape.3

   1 .fp 5 CW
   2 .de Af
   3 .ds ;G \\*(;G\\f\\$1\\$3\\f\\$2
   4 .if !\a\\$4\a\a .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
   5 ..
   6 .de aF
   7 .ie \a\\$3\a\a .ft \\$1
   8 .el \{\
   9 .ds ;G \&
  10 .nr ;G \\n(.f
  11 .Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
  12 \\*(;G
  13 .ft \\n(;G \}
  14 ..
  15 .de L
  16 .aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
  17 ..
  18 .de LR
  19 .aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
  20 ..
  21 .de RL
  22 .aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
  23 ..
  24 .de EX          \" start example
  25 .ta 1i 2i 3i 4i 5i 6i
  26 .PP
  27 .RS
  28 .PD 0
  29 .ft 5
  30 .nf
  31 ..
  32 .de EE          \" end example
  33 .fi
  34 .ft
  35 .PD
  36 .RE
  37 .PP
  38 ..
  39 .TH STRTAPE 3
  40 .SH NAME
  41 strtape \- convert string to tape device pathname
  42 .SH SYNOPSIS
  43 .L "char* strtape(char* s, char** e)"
  44 .SH DESCRIPTION
  45 .I strtape
  46 converts the generic tape device specification in the nul-terminated string
  47 .I s
  48 to a local tape device pathname.
  49 A pointer to the device pathname is returned.
  50 If
  51 .I e
  52 not 0 then
  53 .I *e
  54 is set to point to the first unrecognized character in
  55 .IR s .
  56 .PP
  57 A tape device specification is composed of
  58 .IR unit-density-rewind .
  59 All are optional.
  60 .I unit
  61 is a unit number in the range
  62 .BR [0-7] .
  63 The default unit is
  64 .BR 1 .
  65 Density may be one of:
  66 .TP 3
  67 .B l
  68 for low;
  69 .TP 3
  70 .B m
  71 for medium, and
  72 .TP
  73 .B h
  74 for high.
  75 .PP
  76 The default is
  77 .BR m .
  78 .I rewind
  79 is
  80 .B n
  81 for no-rewind on device close.
  82 The default is to rewind on device close.
  83 .SH "SEE ALSO"
  84 pax(1), tar(1)
  85 .SH CAVEATS
  86 The return value points to a static area that is overwritten on each call.