parport_register_port(9) [suse man page]

PARPORT_REGISTER_POR(9) 				       Parallel Port Devices					   PARPORT_REGISTER_POR(9)

NAME

       parport_register_port - register a parallel port

SYNOPSIS

       struct parport * parport_register_port(unsigned long base, int irq, int dma, struct parport_operations * ops);

ARGUMENTS

       base
	   base I/O address

       irq
	   IRQ line

       dma
	   DMA channel

       ops
	   pointer to the port driver's port operations structure

DESCRIPTION

       When a parallel port (lowlevel) driver finds a port that should be made available to parallel port device drivers, it should call
       parport_register_port. The base, irq, and dma parameters are for the convenience of port drivers, and for ports where they aren't
       meaningful needn't be set to anything special. They can be altered afterwards by adjusting the relevant members of the parport structure
       that is returned and represents the port. They should not be tampered with after calling parport_announce_port, however.

       If there are parallel port device drivers in the system that have registered themselves using parport_register_driver, they are not told
       about the port at this time; that is done by parport_announce_port.

       The ops structure is allocated by the caller, and must not be deallocated before calling parport_remove_port.

       If there is no memory to allocate a new parport structure, this function will return NULL.

COPYRIGHT

Kernel Hackers Manual 2.6.					     July 2010						   PARPORT_REGISTER_POR(9)

IEEE1284_DATA(3)						     Functions							  IEEE1284_DATA(3)

NAME

       ieee1284_read_data, ieee1284_write_data, ieee1284_data_dir, ieee1284_wait_data - control the data lines

SYNOPSIS

       #include <ieee1284.h>

       int ieee1284_read_data(struct parport *port);

       void ieee1284_write_data(struct parport *port, unsigned char dt);

       int ieee1284_data_dir(struct parport *port, int reverse);

       int ieee1284_wait_data(struct parport *port, unsigned char mask, unsigned char val, struct timeval *timeout);

DESCRIPTION

       These functions manipulate the data lines of the parallel port associated with port (which must have been claimed using ieee1284_claim(3)).
       The lines are represented by an 8-bit number (one line per bit) and a direction. The data lines are driven as a group; they may be all
       host-driven (forward direction) or not (reverse direction). When the peripheral is driving them the host must not.

       For ieee1284_data_dir the reverse parameter should be zero to turn the data line drivers on and non-zero to turn them off. Some port types
       may be unable to switch off the data line drivers.

       Setting the data lines may have side effects on some port types (for example, some Amiga ports pulse nStrobe).

       ieee1284_wait_data waits, up until the timeout, for the data bits specified in mask to have the corresponding values in val.

RETURN VALUE

       ieee1284_read_data returns the 8-bit number representing the data lines unless it is not possible to return such a value with this port
       type, in which case it returns an error code. Possible error codes:

       E1284_NOTAVAIL
	   Bi-directional data lines are not available on this system.

       E1284_INVALIDPORT
	   The port parameter is invalid (perhaps it has not been claimed, for instance).

       E1284_SYS
	   There was an error at the operating system level, and errno has been set accordingly.

       E1284_TIMEDOUT
	   The timeout has elapsed.

       Whereas ieee1284_read_data may return E1284_NOTAVAIL on its first invocation on the port, if it does not do so then it cannot until
       ieee1284_close is called for that port.

AUTHOR

       Tim Waugh <twaugh@redhat.com>
	   Author.

COPYRIGHT

       Copyright (C) 2001-2003 Tim Waugh

								    09/18/2007							  IEEE1284_DATA(3)