inb(9F) 						   Kernel Functions for Drivers 						   inb(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_get8(9F), and
       ddi_get8(9F) instead. For repinsb(), repinsw(), andrepinsl(), use, respectively, ddi_rep_get8(9F), ddi_rep_get8(9F),  and  ddi_rep_get8(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 multiple 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

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

CONTEXT

       These functions may be called from user, interrupt, or kernel context.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Architecture		     |x86			   |
       +-----------------------------+-----------------------------+
       |Stability Level 	     | Obsolete 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       isa(4), attributes(5), ddi_get8(9F), ddi_get8(9F), ddi_get8(9F), ddi_rep_get8(9F), ddi_rep_get8(9F), ddi_rep_get8(9F), outb(9F)

       Writing Device Drivers

SunOS 5.11							    16 Jan 2006 							   inb(9F)