outpw()

write a word to an 80x86 hardware port

Synopsis:

#include <conio.h>
unsigned int outpw( int port,
                    unsigned int value );

Description:

The outpw() function writes a word (two bytes), determined by value, to the 80x86 hardware port whose number is given by port.

A hardware port is used to communicate with a device. One, two or four bytes can be read and/or written from each port, depending on the hardware. Consult the technical documentation for your computer to determine the port numbers for a device and the expected usage of each port for a device.

Returns:

The value transmitted.

Examples:

#include <conio.h>
#define DEVICE 34

void main()
  {
    outpw( DEVICE, 0x1234 );
  }

Classification:

Intel

Caveats:

When you use the outpw() function, your program must be linked for privity level 1, and the process must be run by the superuser or by a setuid program owned by the superuser. For more information on privity, see

• the cc -T option
• the Linker PRIVILEGE option.

See also:

inp(), inpd(), inpw(), outp(), outpd()