share/man/man4/man4.vax/vp.4

   1 .\"     $NetBSD: vp.4,v 1.10 2002/01/15 02:11:31 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1980, 1991, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     from: @(#)vp.4  8.1 (Berkeley) 6/5/93
  31 .\"
  32 .Dd June 5, 1993
  33 .Dt VP 4 vax
  34 .Os
  35 .Sh NAME
  36 .Nm vp
  37 .Nd Versatec printer/plotter interface
  38 .Sh SYNOPSIS
  39 .Cd "vp0 at uba0 csr 0177510 vector vpintr vpintr"
  40 .Sh DESCRIPTION
  41 NOTE: This driver has not been ported from
  42 .Bx 4.4
  43 yet.
  44 .Pp
  45 The Versatec printer/plotter is normally used with the
  46 line printer system.
  47 This description is designed for those who wish to drive the Versatec directly.
  48 .Pp
  49 To use the Versatec yourself, you must realize that you cannot open the
  50 device,
  51 .Pa /dev/vp0
  52 if there is a daemon active.
  53 You can see if there is a daemon active by doing a
  54 .Xr lpq 1 ,
  55 and seeing if there are any files being sent.
  56 Printing should be turned off using
  57 .Xr lpc 8 .
  58 .Pp
  59 To set the Versatec into plot mode you should include
  60 .Aq Pa sys/vcmd.h
  61 and use the
  62 .Xr ioctl 2
  63 call
  64 .Bd -literal -offset indent
  65 ioctl(fileno(vp), VSETSTATE, plotmd);
  66 .Ed
  67 .Pp
  68 where
  69 .Em plotmd
  70 is defined to be
  71 .Bd -literal -offset indent
  72 int plotmd[] = { VPLOT, 0, 0 };
  73 .Ed
  74 .Pp
  75 and
  76 .Em vp
  77 is the result of a call to
  78 .Xr fopen 3
  79 on stdio.
  80 When you finish using the Versatec in plot mode you should eject paper
  81 by sending it a
  82 .Tn EOT
  83 after putting it back into print mode, i.e. by
  84 .Bd -literal -offset indent
  85 int prtmd[] = { VPRINT, 0, 0 };
  86 \&...
  87 fflush(vp);
  88 ioctl(fileno(vp), VSETSTATE, prtmd);
  89 write(fileno(vp), "\e04", 1);
  90 .Ed
  91 .Sh FILES
  92 .Bl -tag -width /dev/vp0xx -compact
  93 .It Pa /dev/vp0
  94 .El
  95 .Sh DIAGNOSTICS
  96 The following error numbers are significant at the
  97 time the device is opened.
  98 .Bl -tag -width [ENXIO]
  99 .It Bq Er ENXIO
 100 The device is already in use.
 101 .It Bq Er EIO
 102 The device is offline.
 103 .El
 104 .Sh SEE ALSO
 105 .Xr lpr 1 ,
 106 .\".Xr vtroff 1 ,
 107 .Xr va 4 ,
 108 .\".Xr font 5 ,
 109 .Xr lpd 8
 110 .Sh HISTORY
 111 A
 112 .Nm
 113 driver appeared in
 114 .At v7 .
 115 .Sh BUGS
 116 The configuration part of the driver assumes that the device is set up to
 117 vector print mode through 0174 and plot mode through 0200.
 118 As the configuration program can't be sure
 119 which vector interrupted at boot time,
 120 we specify that it has two interrupt vectors,
 121 and if an interrupt comes through 0200 it is reset to 0174.
 122 This is safe for devices with one or two vectors at these two addresses.
 123 Other configurations with 2 vectors may require changes in the driver.