Unlike the ecpp(4D) driver, usbprn resets configuration variables to their default values with each attach(9E). (The ecpp(4D) driver resets configuration variables with each open(2).)

Gets current transfer parameters. The argument is a pointer to struct ecpp_transfer_parms. If parameters are not configured after the device is opened, the structure will be set to its default configuration.

Note -

Sets transfer parameters. The argument is a pointer to a struct ecpp_transfer_parms. If a parameter is out of range, EINVAL is returned. If the peripheral or host device cannot support the requested mode, EPROTONOSUPPORT is returned. The transfer parameters structure is defined in <sys/ecppio.h>:

struct ecpp_transfer_parms {
 int write_timeout;
 int mode;
};

Note -

Tests the transfer readiness of a print device and checks status bits to determine if a write(2) will succeed. If status bits are set, a transfer will fail. If a transfer will succeed, zero is returned. If a transfer fails, the driver returns EIO and the state of the status bits are captured. The captured status can be retrieved using the BPPIOC_GETERR ioctl(2) call.

Note -

Get last error status. The argument is a pointer to a struct bpp_error_status. This structure indicates the status of all the appropriate status bits at the time of the most recent error condition during a write(2) call, or the status of the bits at the most recent BPPIOC_TESTIO ioctl(2) call.

struct bpp_error_status {
 char timeout_occurred; /* not used */
 char bus_error; /* not used */
 uchar_t pin_status; /* status of pins which
 /* could cause error */
};

Note -

Gets the IEEE 1284 device ID from the peripheral. The argument is a pointer to a struct ecpp_device_id. Applications should set mode to ECPP_CENTRONICS. If another mode is used, the driver will return EPROTONOSUPPORT. len is the length of the buffer pointed to by addr. rlen is the actual length of the device ID string returned from the peripheral. If the returned rlen is greater than len, the application should call ECPPIOC_GETDEVID a second time with a buffer length equal to rlen. The 1284 device ID structure:

struct ecpp_device_id {
 int mode; /* mode to use for reading device id */
 int len; /* length of buffer */
 int rlen; /* actual length of device id string */
 char *addr; /* buffer address */

Note -

The device has been opened and another open is attempted. An attempt has been made to unload the driver while one of the units is open.

An unsupported IOCTL has been received. A ECPPIOC_SETPARMS ioctl(2) is attempted with an out of range value in the ecpp_transfer_parms structure.

The driver has received an unrecoverable device error, or the device is not responding, or the device has stalled when attempting an access. A write(2) or ioctl(2) did not complete due to a peripheral access. A read(2) system call has been issued.

The driver has received an open(2) request for a unit for which the attach failed.

The driver has received an open(2) request for a device that has been disconnected.

The driver has received a ECPPIOC_SETPARMS ioctl(2) for a mode argument other than ECPP_CENTRONICS in the ecpp_transfer_parms structure.

32-bit x86 ELF kernel module

64-bit x86 ELF kernel module

64-bit SPARC ELF kernel module

ugen(4D) nodes.

Character special files

The device has been hot-removed or powered off while it was open and a possible data transfer was in progress. The job may be aborted.

There was an error in accessing the printer during reconnect. Please reconnect the device.

A USB printer was hot-removed while open. A new device was hot-inserted which is not identical to the original USB printer. Please disconnect the USB device and reconnect the printer to the same port.

The printer that was hot-removed from its USB port has been re-inserted again to the same port. It is available for access but the job that was running prior to the hot-removal may be lost.