usr/src/man/man9f/outb.9f

   1 '\" te
   2 .\" Copyright (c) 2006, Sun Microsystems, Inc., All RIghts Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH OUTB 9F "Oct 24, 2012"
   7 .SH NAME
   8 outb, outw, outl, repoutsb, repoutsw, repoutsd \- write to an I/O port
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 #include <sys/ddi.h>
  13 #include <sys/sunddi.h>
  14
  15 \fBvoid\fR \fBoutb\fR(\fBint\fR \fIport\fR, \fBunsigned char\fR \fIvalue\fR);
  16 .fi
  17
  18 .LP
  19 .nf
  20 \fBvoid\fR \fBoutw\fR(\fBint\fR \fIport\fR, \fBunsigned short\fR \fIvalue\fR);
  21 .fi
  22
  23 .LP
  24 .nf
  25 \fBvoid\fR \fBoutl\fR(\fBint\fR \fIport\fR, \fBunsigned long\fR \fIvalue\fR);
  26 .fi
  27
  28 .LP
  29 .nf
  30 \fBvoid\fR \fBrepoutsb\fR(\fBint\fR \fIport\fR, \fBunsigned char *\fR\fIaddr\fR, \fBint\fR \fIcount\fR);
  31 .fi
  32
  33 .LP
  34 .nf
  35 \fBvoid\fR \fBrepoutsw\fR(\fBint\fR \fIport\fR, \fBunsigned short *\fR\fIaddr\fR, \fBint\fR \fIcount\fR);
  36 .fi
  37
  38 .LP
  39 .nf
  40 \fBvoid\fR \fBrepoutsd\fR(\fBint\fR \fIport\fR, \fBunsigned long *\fR\fIaddr\fR, \fBint\fR \fIcount\fR);
  41 .fi
  42
  43 .SH INTERFACE LEVEL
  44 .sp
  45 .LP
  46 The functions described here are obsolete. For the \fBoutb()\fR, \fBoutw()\fR,
  47 and \fBoutl()\fR functions use, respectively, \fBddi_put8\fR(9F),
  48 \fBddi_put16\fR(9F), and \fBddi_put32\fR(9F) instead. For \fBrepoutsb()\fR,
  49 \fBrepoutsw()\fR, and\fBrepoutsl()\fR, use, respectively,
  50 \fBddi_rep_put8\fR(9F), \fBddi_rep_put16\fR(9F), and \fBddi_rep_put32\fR(9F)
  51 instead.
  52 .SH PARAMETERS
  53 .sp
  54 .ne 2
  55 .na
  56 \fB\fIport\fR\fR
  57 .ad
  58 .RS 9n
  59 A valid \fBI/O\fR port address.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fIvalue\fR\fR
  66 .ad
  67 .RS 9n
  68 The data to be written to the \fBI/O\fR port.
  69 .RE
  70
  71 .sp
  72 .ne 2
  73 .na
  74 \fB\fIaddr\fR\fR
  75 .ad
  76 .RS 9n
  77 The address of a buffer from which the values will be fetched.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fIcount\fR\fR
  84 .ad
  85 .RS 9n
  86 The number of values to be written to the \fBI/O\fR port.
  87 .RE
  88
  89 .SH DESCRIPTION
  90 .sp
  91 .LP
  92 These routines write data of various sizes to the \fBI/O\fR port with the
  93 address specified by \fIport\fR.
  94 .sp
  95 .LP
  96 The \fBoutb()\fR, \fBoutw()\fR, and \fBoutl()\fR functions write 8 bits, 16
  97 bits, and 32 bits of data respectively, writing the data specified by
  98 \fIvalue\fR.
  99 .sp
 100 .LP
 101 The \fBrepoutsb()\fR, \fBrepoutsw()\fR, and \fBrepoutsd()\fR functions write
 102 multiple 8-bit, 16-bit, and 32-bit values, respectively. \fIcount\fR specifies
 103 the number of values to be written. \fIaddr\fR is a pointer to a buffer from
 104 which the output values are fetched.
 105 .SH CONTEXT
 106 .sp
 107 .LP
 108 These functions may be called from user, interrupt, or kernel context.
 109 .SH ATTRIBUTES
 110 .sp
 111 .LP
 112 See \fBattributes\fR(5) for descriptions of the following attributes:
 113 .sp
 114
 115 .sp
 116 .TS
 117 box;
 118 c | c
 119 l | l .
 120 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 121 _
 122 Architecture    x86
 123 _
 124 Interface Stability     Obsolete
 125 .TE
 126
 127 .SH SEE ALSO
 128 .sp
 129 .LP
 130 \fBisa\fR(4), \fBattributes\fR(5), \fBddi_put8\fR(9F), \fBddi_put16\fR(9F),
 131 \fBddi_put32\fR(9F), \fBddi_rep_put8\fR(9F), \fBddi_rep_put16\fR(9F),
 132 \fBddi_rep_put32\fR(9F), \fBinb\fR(9F)
 133 .sp
 134 .LP
 135 \fIWriting Device Drivers\fR