inw(9F)

NAME

     inb, inw, inl, repinsb, repinsw, repinsd - read from an  I/O
     port

SYNOPSIS

     #include <sys/ddi.h>
     #include <sys/sunddi.h>

     unsigned char inb(int port);

     unsigned short inw(int port);

     unsigned long inl(int port);

     void repinsb(int port, unsigned char *addr, int count);

     void repinsw(int port, unsigned short *addr, int count);

     void repinsd(int port, unsigned long *addr, int count);

INTERFACE LEVEL

     The functions described here are obsolete.  For  the  inb(),
     inw(), and inl() functions, use, respectively, ddi_get8(9F),
     ddi_get16(9F), and  ddi_get32(9F)  instead.  For  repinsb(),
     repinsw(),       andrepinsl(),       use,      respectively,
     ddi_rep_get8(9F), ddi_rep_get16(9F),  and  ddi_rep_get32(9F)
     instead.

PARAMETERS

     port  A valid I/O port address.

     addr  The address of a  buffer  where  the  values  will  be
           stored.

     count The number of values to be read from the I/O port.

DESCRIPTION

     These routines read data of various sizes from the I/O  port
     with the address specified by port.

     The inb(), inw(), and inl() functions read 8 bits, 16  bits,
     and  32  bits  of data respectively, returning the resulting
     values.

     The repinsb(), repinsw(), and repinsd() functions read  mul-
     tiple  8-bit, 16-bit, and 32-bit values, respectively. count
     specifies the number of values to be read. A  pointer  to  a
     buffer  will receive the input data; the buffer must be long
     enough to hold count values of the requested size.

RETURN VALUES

     inb(), inw(), and inl() return the value that was read  from
     the I/O port.

CONTEXT

     These functions may be called from user  or  interrupt  con-
     text.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Architecture                | x86                         |
    |_____________________________|_____________________________|
    | Stability Level             |  Obsolete                   |
    |_____________________________|_____________________________|

SEE ALSO

     eisa(4), isa(4), attributes(5), ddi_get8(9F), ddi_get16(9F),
     ddi_get32(9F),      ddi_rep_get8(9F),     ddi_rep_get16(9F),
     ddi_rep_get32(9F), outb(9F)

     Writing Device Drivers