sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget//translations/zh_CN/driver-api/parport-lowlevelmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/zh_TW/driver-api/parport-lowlevelmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/it_IT/driver-api/parport-lowlevelmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/ja_JP/driver-api/parport-lowlevelmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/ko_KR/driver-api/parport-lowlevelmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/pt_BR/driver-api/parport-lowlevelmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/sp_SP/driver-api/parport-lowlevelmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hPARPORT interface documentationh]hPARPORT interface documentation}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhI/var/lib/git/docbuild/linux/Documentation/driver-api/parport-lowlevel.rsthKubh field_list)}(hhh]hfield)}(hhh](h field_name)}(h Time-stamph]h Time-stamp}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(h<2000-02-24 13:30:20 twaugh> h]h paragraph)}(h<2000-02-24 13:30:20 twaugh>h]h<2000-02-24 13:30:20 twaugh>}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(h+Described here are the following functions:h]h+Described here are the following functions:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hGlobal functions::h]hGlobal functions:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh literal_block)}(hXparport_register_driver parport_unregister_driver parport_enumerate parport_register_device parport_unregister_device parport_claim parport_claim_or_block parport_release parport_yield parport_yield_blocking parport_wait_peripheral parport_poll_peripheral parport_wait_event parport_negotiate parport_read parport_write parport_open parport_close parport_device_id parport_device_coords parport_find_class parport_find_device parport_set_timeouth]hXparport_register_driver parport_unregister_driver parport_enumerate parport_register_device parport_unregister_device parport_claim parport_claim_or_block parport_release parport_yield parport_yield_blocking parport_wait_peripheral parport_poll_peripheral parport_wait_event parport_negotiate parport_read parport_write parport_open parport_close parport_device_id parport_device_coords parport_find_class parport_find_device parport_set_timeout}hj+sbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1j)hhhK hhhhubh)}(h8Port functions (can be overridden by low-level drivers):h]h8Port functions (can be overridden by low-level drivers):}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hhhhubh block_quote)}(hX7SPP:: port->ops->read_data port->ops->write_data port->ops->read_status port->ops->read_control port->ops->write_control port->ops->frob_control port->ops->enable_irq port->ops->disable_irq port->ops->data_forward port->ops->data_reverse EPP:: port->ops->epp_write_data port->ops->epp_read_data port->ops->epp_write_addr port->ops->epp_read_addr ECP:: port->ops->ecp_write_data port->ops->ecp_read_data port->ops->ecp_write_addr Other:: port->ops->nibble_read_data port->ops->byte_read_data port->ops->compat_write_data h](h)}(hSPP::h]hSPP:}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjKubj*)}(hport->ops->read_data port->ops->write_data port->ops->read_status port->ops->read_control port->ops->write_control port->ops->frob_control port->ops->enable_irq port->ops->disable_irq port->ops->data_forward port->ops->data_reverseh]hport->ops->read_data port->ops->write_data port->ops->read_status port->ops->read_control port->ops->write_control port->ops->frob_control port->ops->enable_irq port->ops->disable_irq port->ops->data_forward port->ops->data_reverse}hj]sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhK'hjKubh)}(hEPP::h]hEPP:}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hjKubj*)}(heport->ops->epp_write_data port->ops->epp_read_data port->ops->epp_write_addr port->ops->epp_read_addrh]heport->ops->epp_write_data port->ops->epp_read_data port->ops->epp_write_addr port->ops->epp_read_addr}hjysbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhK4hjKubh)}(hECP::h]hECP:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjKubj*)}(hLport->ops->ecp_write_data port->ops->ecp_read_data port->ops->ecp_write_addrh]hLport->ops->ecp_write_data port->ops->ecp_read_data port->ops->ecp_write_addr}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhK;hjKubh)}(hOther::h]hOther:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjKubj*)}(hRport->ops->nibble_read_data port->ops->byte_read_data port->ops->compat_write_datah]hRport->ops->nibble_read_data port->ops->byte_read_data port->ops->compat_write_data}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhKAhjKubeh}(h]h ]h"]h$]h&]uh1jIhhhK%hhhhubh)}(hThe parport subsystem comprises ``parport`` (the core port-sharing code), and a variety of low-level drivers that actually do the port accesses. Each low-level driver handles a particular style of port (PC, Amiga, and so on).h](h The parport subsystem comprises }(hjhhhNhNubhliteral)}(h ``parport``h]hparport}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh (the core port-sharing code), and a variety of low-level drivers that actually do the port accesses. Each low-level driver handles a particular style of port (PC, Amiga, and so on).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKEhhhhubh)}(hnThe parport interface to the device driver author can be broken down into global functions and port functions.h]hnThe parport interface to the device driver author can be broken down into global functions and port functions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhhhhubh)}(hX2The global functions are mostly for communicating between the device driver and the parport subsystem: acquiring a list of available ports, claiming a port for exclusive use, and so on. They also include ``generic`` functions for doing standard things that will work on any IEEE 1284-capable architecture.h](hThe global functions are mostly for communicating between the device driver and the parport subsystem: acquiring a list of available ports, claiming a port for exclusive use, and so on. They also include }(hjhhhNhNubj)}(h ``generic``h]hgeneric}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhZ functions for doing standard things that will work on any IEEE 1284-capable architecture.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKMhhhhubh)}(hThe port functions are provided by the low-level drivers, although the core parport module provides generic ``defaults`` for some routines. The port functions can be split into three groups: SPP, EPP, and ECP.h](hlThe port functions are provided by the low-level drivers, although the core parport module provides generic }(hjhhhNhNubj)}(h ``defaults``h]hdefaults}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhY for some routines. The port functions can be split into three groups: SPP, EPP, and ECP.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKShhhhubh)}(hXASPP (Standard Parallel Port) functions modify so-called ``SPP`` registers: data, status, and control. The hardware may not actually have registers exactly like that, but the PC does and this interface is modelled after common PC implementations. Other low-level drivers may be able to emulate most of the functionality.h](h8SPP (Standard Parallel Port) functions modify so-called }(hj5hhhNhNubj)}(h``SPP``h]hSPP}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubhX registers: data, status, and control. The hardware may not actually have registers exactly like that, but the PC does and this interface is modelled after common PC implementations. Other low-level drivers may be able to emulate most of the functionality.}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKWhhhhubh)}(hEPP (Enhanced Parallel Port) functions are provided for reading and writing in IEEE 1284 EPP mode, and ECP (Extended Capabilities Port) functions are used for IEEE 1284 ECP mode. (What about BECP? Does anyone care?)h]hEPP (Enhanced Parallel Port) functions are provided for reading and writing in IEEE 1284 EPP mode, and ECP (Extended Capabilities Port) functions are used for IEEE 1284 ECP mode. (What about BECP? Does anyone care?)}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hhhhubh)}(hXYHardware assistance for EPP and/or ECP transfers may or may not be available, and if it is available it may or may not be used. If hardware is not used, the transfer will be software-driven. In order to cope with peripherals that only tenuously support IEEE 1284, a low-level driver specific function is provided, for altering 'fudge factors'.h]hX]Hardware assistance for EPP and/or ECP transfers may or may not be available, and if it is available it may or may not be used. If hardware is not used, the transfer will be software-driven. In order to cope with peripherals that only tenuously support IEEE 1284, a low-level driver specific function is provided, for altering ‘fudge factors’.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhhhhubh)}(hhh](h)}(hGlobal functionsh]hGlobal functions}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhhhhhKkubh)}(hhh](h)}(h?parport_register_driver - register a device driver with parporth]h?parport_register_driver - register a device driver with parport}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKnubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKqubj*)}(hX#include struct parport_driver { const char *name; void (*attach) (struct parport *); void (*detach) (struct parport *); struct parport_driver *next; }; int parport_register_driver (struct parport_driver *driver);h]hX#include struct parport_driver { const char *name; void (*attach) (struct parport *); void (*detach) (struct parport *); struct parport_driver *next; }; int parport_register_driver (struct parport_driver *driver);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhKuhjhhubeh}(h]synopsisah ]h"]h$]synopsisah&]uh1hhjhhhhhKq referencedKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hIn order to be notified about parallel ports when they are detected, parport_register_driver should be called. Your driver will immediately be notified of all ports that have already been detected, and of each new port as low-level drivers are loaded.h]hIn order to be notified about parallel ports when they are detected, parport_register_driver should be called. Your driver will immediately be notified of all ports that have already been detected, and of each new port as low-level drivers are loaded.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX6A ``struct parport_driver`` contains the textual name of your driver, a pointer to a function to handle new ports, and a pointer to a function to handle ports going away due to a low-level driver unloading. Ports will only be detached if they are not being used (i.e. there are no devices registered on them).h](hA }(hjhhhNhNubj)}(h``struct parport_driver``h]hstruct parport_driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX contains the textual name of your driver, a pointer to a function to handle new ports, and a pointer to a function to handle ports going away due to a low-level driver unloading. Ports will only be detached if they are not being used (i.e. there are no devices registered on them).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hSThe visible parts of the ``struct parport *`` argument given to attach/detach are::h](hThe visible parts of the }(hjhhhNhNubj)}(h``struct parport *``h]hstruct parport *}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh% argument given to attach/detach are:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj*)}(hX|struct parport { struct parport *next; /* next parport in list */ const char *name; /* port's name */ unsigned int modes; /* bitfield of hardware modes */ struct parport_device_info probe_info; /* IEEE1284 info */ int number; /* parport index */ struct parport_operations *ops; ... };h]hX|struct parport { struct parport *next; /* next parport in list */ const char *name; /* port's name */ unsigned int modes; /* bitfield of hardware modes */ struct parport_device_info probe_info; /* IEEE1284 info */ int number; /* parport index */ struct parport_operations *ops; ... };}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhKhjhhubh)}(hIThere are other members of the structure, but they should not be touched.h]hIThere are other members of the structure, but they should not be touched.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hThe ``modes`` member summarises the capabilities of the underlying hardware. It consists of flags which may be bitwise-ored together:h](hThe }(hj6hhhNhNubj)}(h ``modes``h]hmodes}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubhy member summarises the capabilities of the underlying hardware. It consists of flags which may be bitwise-ored together:}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubjJ)}(hX============================= =============================================== PARPORT_MODE_PCSPP IBM PC registers are available, i.e. functions that act on data, control and status registers are probably writing directly to the hardware. PARPORT_MODE_TRISTATE The data drivers may be turned off. This allows the data lines to be used for reverse (peripheral to host) transfers. PARPORT_MODE_COMPAT The hardware can assist with compatibility-mode (printer) transfers, i.e. compat_write_block. PARPORT_MODE_EPP The hardware can assist with EPP transfers. PARPORT_MODE_ECP The hardware can assist with ECP transfers. PARPORT_MODE_DMA The hardware can use DMA, so you might want to pass ISA DMA-able memory (i.e. memory allocated using the GFP_DMA flag with kmalloc) to the low-level driver in order to take advantage of it. ============================= =============================================== h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhjaubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK/uh1jdhjaubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(hPARPORT_MODE_PCSPPh]hPARPORT_MODE_PCSPP}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hIBM PC registers are available, i.e. functions that act on data, control and status registers are probably writing directly to the hardware.h]hIBM PC registers are available, i.e. functions that act on data, control and status registers are probably writing directly to the hardware.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj|ubj)}(hhh](j)}(hhh]h)}(hPARPORT_MODE_TRISTATEh]hPARPORT_MODE_TRISTATE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(huThe data drivers may be turned off. This allows the data lines to be used for reverse (peripheral to host) transfers.h]huThe data drivers may be turned off. This allows the data lines to be used for reverse (peripheral to host) transfers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj|ubj)}(hhh](j)}(hhh]h)}(hPARPORT_MODE_COMPATh]hPARPORT_MODE_COMPAT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h]The hardware can assist with compatibility-mode (printer) transfers, i.e. compat_write_block.h]h]The hardware can assist with compatibility-mode (printer) transfers, i.e. compat_write_block.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj|ubj)}(hhh](j)}(hhh]h)}(hPARPORT_MODE_EPPh]hPARPORT_MODE_EPP}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj+ubah}(h]h ]h"]h$]h&]uh1jhj(ubj)}(hhh]h)}(h+The hardware can assist with EPP transfers.h]h+The hardware can assist with EPP transfers.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjBubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj|ubj)}(hhh](j)}(hhh]h)}(hPARPORT_MODE_ECPh]hPARPORT_MODE_ECP}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjbubah}(h]h ]h"]h$]h&]uh1jhj_ubj)}(hhh]h)}(h+The hardware can assist with ECP transfers.h]h+The hardware can assist with ECP transfers.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjyubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj|ubj)}(hhh](j)}(hhh]h)}(hPARPORT_MODE_DMAh]hPARPORT_MODE_DMA}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hThe hardware can use DMA, so you might want to pass ISA DMA-able memory (i.e. memory allocated using the GFP_DMA flag with kmalloc) to the low-level driver in order to take advantage of it.h]hThe hardware can use DMA, so you might want to pass ISA DMA-able memory (i.e. memory allocated using the GFP_DMA flag with kmalloc) to the low-level driver in order to take advantage of it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jzhjaubeh}(h]h ]h"]h$]h&]colsKuh1j_hj\ubah}(h]h ]h"]h$]h&]uh1jZhjVubah}(h]h ]h"]h$]h&]uh1jIhhhKhjhhubh)}(h.There may be other flags in ``modes`` as well.h](hThere may be other flags in }(hjhhhNhNubj)}(h ``modes``h]hmodes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh as well.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX$The contents of ``modes`` is advisory only. For example, if the hardware is capable of DMA, and PARPORT_MODE_DMA is in ``modes``, it doesn't necessarily mean that DMA will always be used when possible. Similarly, hardware that is capable of assisting ECP transfers won't necessarily be used.h](hThe contents of }(hjhhhNhNubj)}(h ``modes``h]hmodes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh_ is advisory only. For example, if the hardware is capable of DMA, and PARPORT_MODE_DMA is in }(hjhhhNhNubj)}(h ``modes``h]hmodes}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, it doesn’t necessarily mean that DMA will always be used when possible. Similarly, hardware that is capable of assisting ECP transfers won’t necessarily be used.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] descriptionah ]h"]h$] descriptionah&]uh1hhjhhhhhKjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hhhhhKubh)}(h)Zero on success, otherwise an error code.h]h)Zero on success, otherwise an error code.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj@hhubeh}(h] return-valueah ]h"]h$] return valueah&]uh1hhjhhhhhKjKubh)}(hhh](h)}(hERRORSh]hERRORS}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghhhhhKubh)}(h$None. (Can it fail? Why return int?)h]h$None. (Can it fail? Why return int?)}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjghhubeh}(h]errorsah ]h"]h$]errorsah&]uh1hhjhhhhhKjKubh)}(hhh](h)}(hEXAMPLEh]hEXAMPLE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubj*)}(hX$static void lp_attach (struct parport *port) { ... private = kmalloc (...); dev[count++] = parport_register_device (...); ... } static void lp_detach (struct parport *port) { ... } static struct parport_driver lp_driver = { "lp", lp_attach, lp_detach, NULL /* always put NULL here */ }; int lp_init (void) { ... if (parport_register_driver (&lp_driver)) { /* Failed; nothing we can do. */ return -EIO; } ... }h]hX$static void lp_attach (struct parport *port) { ... private = kmalloc (...); dev[count++] = parport_register_device (...); ... } static void lp_detach (struct parport *port) { ... } static struct parport_driver lp_driver = { "lp", lp_attach, lp_detach, NULL /* always put NULL here */ }; int lp_init (void) { ... if (parport_register_driver (&lp_driver)) { /* Failed; nothing we can do. */ return -EIO; } ... }}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhKhjhhubeh}(h]exampleah ]h"]h$]exampleah&]uh1hhjhhhhhKjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hEparport_unregister_driver, parport_register_device, parport_enumerateh]hEparport_unregister_driver, parport_register_device, parport_enumerate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]see-alsoah ]h"]h$]see alsoah&]uh1hhjhhhhhKjKubeh}(h]=parport-register-driver-register-a-device-driver-with-parportah ]h"]?parport_register_driver - register a device driver with parportah$]h&]uh1hhjqhhhhhKnubh)}(hhh](h)}(hDparport_unregister_driver - tell parport to forget about this driverh]hDparport_unregister_driver - tell parport to forget about this driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubj*)}(hX #include struct parport_driver { const char *name; void (*attach) (struct parport *); void (*detach) (struct parport *); struct parport_driver *next; }; void parport_unregister_driver (struct parport_driver *driver);h]hX #include struct parport_driver { const char *name; void (*attach) (struct parport *); void (*detach) (struct parport *); struct parport_driver *next; }; void parport_unregister_driver (struct parport_driver *driver);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id1ah ]h"]h$]jah&]uh1hhjhhhhhKjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM ubh)}(hThis tells parport not to notify the device driver of new ports or of ports going away. Registered devices belonging to that driver are NOT unregistered: parport_unregister_device must be used for each one.h]hThis tells parport not to notify the device driver of new ports or of ports going away. Registered devices belonging to that driver are NOT unregistered: parport_unregister_device must be used for each one.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjhhubeh}(h]id2ah ]h"]h$]j>ah&]uh1hhjhhhhhM jKubh)}(hhh](h)}(hEXAMPLEh]hEXAMPLE}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhhhhhMubj*)}(hXvoid cleanup_module (void) { ... /* Stop notifications. */ parport_unregister_driver (&lp_driver); /* Unregister devices. */ for (i = 0; i < NUM_DEVS; i++) parport_unregister_device (dev[i]); ... }h]hXvoid cleanup_module (void) { ... /* Stop notifications. */ parport_unregister_driver (&lp_driver); /* Unregister devices. */ for (i = 0; i < NUM_DEVS; i++) parport_unregister_device (dev[i]); ... }}hjRsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjAhhubeh}(h]id3ah ]h"]h$]jah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghhhhhM#ubh)}(h*parport_register_driver, parport_enumerateh]h*parport_register_driver, parport_enumerate}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM%hjghhubeh}(h]id4ah ]h"]h$]jah&]uh1hhjhhhhhM#jKubeh}(h]Bparport-unregister-driver-tell-parport-to-forget-about-this-driverah ]h"]Dparport_unregister_driver - tell parport to forget about this driverah$]h&]uh1hhjqhhhhhKubh)}(hhh](h)}(hBparport_enumerate - retrieve a list of parallel ports (DEPRECATED)h]hBparport_enumerate - retrieve a list of parallel ports (DEPRECATED)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM*ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM-ubj*)}(hE#include struct parport *parport_enumerate (void);h]hE#include struct parport *parport_enumerate (void);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM1hjhhubeh}(h]id5ah ]h"]h$]synopsisah&]uh1hhjhhhhhM-jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM6ubh)}(hXHRetrieve the first of a list of valid parallel ports for this machine. Successive parallel ports can be found using the ``struct parport *next`` element of the ``struct parport *`` that is returned. If ``next`` is NULL, there are no more parallel ports in the list. The number of ports in the list will not exceed PARPORT_MAX.h](hxRetrieve the first of a list of valid parallel ports for this machine. Successive parallel ports can be found using the }(hjhhhNhNubj)}(h``struct parport *next``h]hstruct parport *next}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh element of the }(hjhhhNhNubj)}(h``struct parport *``h]hstruct parport *}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh that is returned. If }(hjhhhNhNubj)}(h``next``h]hnext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhu is NULL, there are no more parallel ports in the list. The number of ports in the list will not exceed PARPORT_MAX.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM8hjhhubeh}(h]id6ah ]h"]h$] descriptionah&]uh1hhjhhhhhM6jKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhM?ubh)}(hcA ``struct parport *`` describing a valid parallel port for the machine, or NULL if there are none.h](hA }(hj;hhhNhNubj)}(h``struct parport *``h]hstruct parport *}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubhM describing a valid parallel port for the machine, or NULL if there are none.}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMAhj*hhubeh}(h]id7ah ]h"]h$]jeah&]uh1hhjhhhhhM?jKubh)}(hhh](h)}(hERRORSh]hERRORS}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhhhhhMEubh)}(hRThis function can return NULL to indicate that there are no parallel ports to use.h]hRThis function can return NULL to indicate that there are no parallel ports to use.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMGhjbhhubeh}(h]id8ah ]h"]h$]jah&]uh1hhjhhhhhMEjKubh)}(hhh](h)}(hEXAMPLEh]hEXAMPLE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMKubj*)}(hX int detect_device (void) { struct parport *port; for (port = parport_enumerate (); port != NULL; port = port->next) { /* Try to detect a device on the port... */ ... } } ... }h]hX int detect_device (void) { struct parport *port; for (port = parport_enumerate (); port != NULL; port = port->next) { /* Try to detect a device on the port... */ ... } } ... }}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMOhjhhubeh}(h]id9ah ]h"]h$]exampleah&]uh1hhjhhhhhMKjKubh)}(hhh](h)}(hNOTESh]hNOTES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM_ubh)}(hPparport_enumerate is deprecated; parport_register_driver should be used instead.h]hPparport_enumerate is deprecated; parport_register_driver should be used instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMahjhhubeh}(h]notesah ]h"]h$]notesah&]uh1hhjhhhhhM_jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMeubh)}(h2parport_register_driver, parport_unregister_driverh]h2parport_register_driver, parport_unregister_driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMghjhhubeh}(h]id10ah ]h"]h$]see alsoah&]uh1hhjhhhhhMejKubeh}(h]>parport-enumerate-retrieve-a-list-of-parallel-ports-deprecatedah ]h"]Bparport_enumerate - retrieve a list of parallel ports (deprecated)ah$]h&]uh1hhjqhhhhhM*ubh)}(hhh](h)}(h0parport_register_device - register to use a porth]h0parport_register_device - register to use a port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMlubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMoubj*)}(hXW#include typedef int (*preempt_func) (void *handle); typedef void (*wakeup_func) (void *handle); typedef int (*irq_func) (int irq, void *handle, struct pt_regs *); struct pardevice *parport_register_device(struct parport *port, const char *name, preempt_func preempt, wakeup_func wakeup, irq_func irq, int flags, void *handle);h]hXW#include typedef int (*preempt_func) (void *handle); typedef void (*wakeup_func) (void *handle); typedef int (*irq_func) (int irq, void *handle, struct pt_regs *); struct pardevice *parport_register_device(struct parport *port, const char *name, preempt_func preempt, wakeup_func wakeup, irq_func irq, int flags, void *handle);}hj'sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMshjhhubeh}(h]id11ah ]h"]h$]synopsisah&]uh1hhjhhhhhMojKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hhhhhMubh)}(hUse this function to register your device driver on a parallel port (``port``). Once you have done that, you will be able to use parport_claim and parport_release in order to use the port.h](hEUse this function to register your device driver on a parallel port (}(hjNhhhNhNubj)}(h``port``h]hport}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubhp). Once you have done that, you will be able to use parport_claim and parport_release in order to use the port.}(hjNhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(hThe (``name``) argument is the name of the device that appears in /proc filesystem. The string must be valid for the whole lifetime of the device (until parport_unregister_device is called).h](hThe (}(hjnhhhNhNubj)}(h``name``h]hname}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubh) argument is the name of the device that appears in /proc filesystem. The string must be valid for the whole lifetime of the device (until parport_unregister_device is called).}(hjnhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(hThis function will register three callbacks into your driver: ``preempt``, ``wakeup`` and ``irq``. Each of these may be NULL in order to indicate that you do not want a callback.h](h>This function will register three callbacks into your driver: }(hjhhhNhNubj)}(h ``preempt``h]hpreempt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }(hjhhhNhNubj)}(h ``wakeup``h]hwakeup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h``irq``h]hirq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhR. Each of these may be NULL in order to indicate that you do not want a callback.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(hX*When the ``preempt`` function is called, it is because another driver wishes to use the parallel port. The ``preempt`` function should return non-zero if the parallel port cannot be released yet -- if zero is returned, the port is lost to another driver and the port must be re-claimed before use.h](h When the }(hjhhhNhNubj)}(h ``preempt``h]hpreempt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX function is called, it is because another driver wishes to use the parallel port. The }(hjhhhNhNubj)}(h ``preempt``h]hpreempt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh function should return non-zero if the parallel port cannot be released yet -- if zero is returned, the port is lost to another driver and the port must be re-claimed before use.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(hXThe ``wakeup`` function is called once another driver has released the port and no other driver has yet claimed it. You can claim the parallel port from within the ``wakeup`` function (in which case the claim is guaranteed to succeed), or choose not to if you don't need it now.h](hThe }(hj hhhNhNubj)}(h ``wakeup``h]hwakeup}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh function is called once another driver has released the port and no other driver has yet claimed it. You can claim the parallel port from within the }(hj hhhNhNubj)}(h ``wakeup``h]hwakeup}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhj function (in which case the claim is guaranteed to succeed), or choose not to if you don’t need it now.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(hIf an interrupt occurs on the parallel port your driver has claimed, the ``irq`` function will be called. (Write something about shared interrupts here.)h](hIIf an interrupt occurs on the parallel port your driver has claimed, the }(hj6 hhhNhNubj)}(h``irq``h]hirq}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6 ubhI function will be called. (Write something about shared interrupts here.)}(hj6 hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(h]The ``handle`` is a pointer to driver-specific data, and is passed to the callback functions.h](hThe }(hjV hhhNhNubj)}(h ``handle``h]hhandle}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV ubhO is a pointer to driver-specific data, and is passed to the callback functions.}(hjV hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(h>``flags`` may be a bitwise combination of the following flags:h](j)}(h ``flags``h]hflags}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjv ubh5 may be a bitwise combination of the following flags:}(hjv hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubjJ)}(hX}===================== ================================================= Flag Meaning ===================== ================================================= PARPORT_DEV_EXCL The device cannot share the parallel port at all. Use this only when absolutely necessary. ===================== ================================================= h]j[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhj ubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK1uh1jdhj ubhthead)}(hhh]j)}(hhh](j)}(hhh]h)}(hFlagh]hFlag}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hMeaningh]hMeaning}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj{)}(hhh]j)}(hhh](j)}(hhh]h)}(hPARPORT_DEV_EXCLh]hPARPORT_DEV_EXCL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hZThe device cannot share the parallel port at all. Use this only when absolutely necessary.h]hZThe device cannot share the parallel port at all. Use this only when absolutely necessary.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jzhj ubeh}(h]h ]h"]h$]h&]colsKuh1j_hj ubah}(h]h ]h"]h$]h&]uh1jZhj ubah}(h]h ]h"]h$]h&]uh1jIhhhMhj=hhubh)}(hsThe typedefs are not actually defined -- they are only shown in order to make the function prototype more readable.h]hsThe typedefs are not actually defined -- they are only shown in order to make the function prototype more readable.}(hjE hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj=hhubh)}(hdev; if (!dev) return; /* avoid races */ if (want_port) parport_claim (dev); } static int toaster_detect (struct toaster *private, struct parport *port) { private->dev = parport_register_device (port, "toaster", preempt, wakeup, NULL, 0, private); if (!private->dev) /* Couldn't register with parport. */ return -EIO; must_reclaim_port = 0; busy_right_now = 1; parport_claim_or_block (private->dev); ... /* Don't need the port while the toaster warms up. */ busy_right_now = 0; ... busy_right_now = 1; if (must_reclaim_port) { parport_claim_or_block (private->dev); must_reclaim_port = 0; } ... }h]hXstatic int preempt (void *handle) { if (busy_right_now) return 1; must_reclaim_port = 1; return 0; } static void wakeup (void *handle) { struct toaster *private = handle; struct pardevice *dev = private->dev; if (!dev) return; /* avoid races */ if (want_port) parport_claim (dev); } static int toaster_detect (struct toaster *private, struct parport *port) { private->dev = parport_register_device (port, "toaster", preempt, wakeup, NULL, 0, private); if (!private->dev) /* Couldn't register with parport. */ return -EIO; must_reclaim_port = 0; busy_right_now = 1; parport_claim_or_block (private->dev); ... /* Don't need the port while the toaster warms up. */ busy_right_now = 0; ... busy_right_now = 1; if (must_reclaim_port) { parport_claim_or_block (private->dev); must_reclaim_port = 0; } ... }}hj sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj hhubeh}(h]id15ah ]h"]h$]exampleah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(h(parport_unregister_device, parport_claimh]h(parport_unregister_device, parport_claim}(hj! hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]id16ah ]h"]h$]see alsoah&]uh1hhjhhhhhMjKubeh}(h].parport-register-device-register-to-use-a-portah ]h"]0parport_register_device - register to use a portah$]h&]uh1hhjqhhhhhMlubh)}(hhh](h)}(h/parport_unregister_device - finish using a porth]h/parport_unregister_device - finish using a port}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj? hhhhhMubh)}(h SYNPOPSISh]h SYNPOPSIS}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj? hhubj*)}(hS#include void parport_unregister_device (struct pardevice *dev);h]hS#include void parport_unregister_device (struct pardevice *dev);}hj^ sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj? hhubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjl hhhhhMubh)}(hThis function is the opposite of parport_register_device. After using parport_unregister_device, ``dev`` is no longer a valid device handle.h](hbThis function is the opposite of parport_register_device. After using parport_unregister_device, }(hj} hhhNhNubj)}(h``dev``h]hdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj} ubh$ is no longer a valid device handle.}(hj} hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM hjl hhubh)}(hsYou should not unregister a device that is currently claimed, although if you do it will be released automatically.h]hsYou should not unregister a device that is currently claimed, although if you do it will be released automatically.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjl hhubeh}(h]id17ah ]h"]h$] descriptionah&]uh1hhj? hhhhhMjKubh)}(hhh](h)}(hEXAMPLEh]hEXAMPLE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubj*)}(h_... kfree (dev->private); /* before we lose the pointer */ parport_unregister_device (dev); ...h]h_... kfree (dev->private); /* before we lose the pointer */ parport_unregister_device (dev); ...}hj sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj hhubeh}(h]id18ah ]h"]h$]exampleah&]uh1hhj? hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hparport_unregister_driverh]hparport_unregister_driver}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]id19ah ]h"]h$]see alsoah&]uh1hhj? hhhhhMjKubeh}(h]-parport-unregister-device-finish-using-a-portah ]h"]/parport_unregister_device - finish using a portah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(hLparport_claim, parport_claim_or_block - claim the parallel port for a deviceh]hLparport_claim, parport_claim_or_block - claim the parallel port for a device}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM!ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM$ubj*)}(hz#include int parport_claim (struct pardevice *dev); int parport_claim_or_block (struct pardevice *dev);h]hz#include int parport_claim (struct pardevice *dev); int parport_claim_or_block (struct pardevice *dev);}hj+ sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM(hj hhubeh}(h]id20ah ]h"]h$]synopsisah&]uh1hhj hhhhhM$jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjD hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjA hhhhhM.ubh)}(hThese functions attempt to gain control of the parallel port on which ``dev`` is registered. ``parport_claim`` does not block, but ``parport_claim_or_block`` may do. (Put something here about blocking interruptibly or non-interruptibly.)h](hFThese functions attempt to gain control of the parallel port on which }(hjR hhhNhNubj)}(h``dev``h]hdev}(hjZ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR ubh is registered. }(hjR hhhNhNubj)}(h``parport_claim``h]h parport_claim}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR ubh does not block, but }(hjR hhhNhNubj)}(h``parport_claim_or_block``h]hparport_claim_or_block}(hj~ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR ubhP may do. (Put something here about blocking interruptibly or non-interruptibly.)}(hjR hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM0hjA hhubh)}(hAYou should not try to claim a port that you have already claimed.h]hAYou should not try to claim a port that you have already claimed.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM5hjA hhubeh}(h]id21ah ]h"]h$] descriptionah&]uh1hhj hhhhhM.jKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM8ubh)}(hA return value of zero indicates that the port was successfully claimed, and the caller now has possession of the parallel port.h]hA return value of zero indicates that the port was successfully claimed, and the caller now has possession of the parallel port.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM:hj hhubh)}(haIf ``parport_claim_or_block`` blocks before returning successfully, the return value is positive.h](hIf }(hj hhhNhNubj)}(h``parport_claim_or_block``h]hparport_claim_or_block}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhD blocks before returning successfully, the return value is positive.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM=hj hhubeh}(h]id22ah ]h"]h$] return valueah&]uh1hhj hhhhhM8jKubh)}(hhh](h)}(hERRORSh]hERRORS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMAubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jdhj ubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK:uh1jdhj ubj{)}(hhh]j)}(hhh](j)}(hhh]h)}(h-EAGAINh]h-EAGAIN}(hj' hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhj$ ubah}(h]h ]h"]h$]h&]uh1jhj! ubj)}(hhh]h)}(hSThe port is unavailable at the moment, but another attempt to claim it may succeed.h]hSThe port is unavailable at the moment, but another attempt to claim it may succeed.}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhj; ubah}(h]h ]h"]h$]h&]uh1jhj! ubeh}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jzhj ubeh}(h]h ]h"]h$]h&]colsKuh1j_hj ubah}(h]h ]h"]h$]h&]uh1jZhj hhhhhNubeh}(h]id23ah ]h"]h$]errorsah&]uh1hhj hhhhhMAjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjv hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjs hhhhhMIubh)}(hparport_releaseh]hparport_release}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMLhjs hhubeh}(h]id24ah ]h"]h$]see alsoah&]uh1hhj hhhhhMIjKubeh}(h]Iparport-claim-parport-claim-or-block-claim-the-parallel-port-for-a-deviceah ]h"]Lparport_claim, parport_claim_or_block - claim the parallel port for a deviceah$]h&]uh1hhjqhhhhhM!ubh)}(hhh](h)}(h+parport_release - release the parallel porth]h+parport_release - release the parallel port}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMPubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMSubj*)}(hI#include void parport_release (struct pardevice *dev);h]hI#include void parport_release (struct pardevice *dev);}hj sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMWhj hhubeh}(h]id25ah ]h"]h$]synopsisah&]uh1hhj hhhhhMSjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM\ubh)}(hOnce a parallel port device has been claimed, it can be released using ``parport_release``. It cannot fail, but you should not release a device that you do not have possession of.h](hGOnce a parallel port device has been claimed, it can be released using }(hj hhhNhNubj)}(h``parport_release``h]hparport_release}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhZ. It cannot fail, but you should not release a device that you do not have possession of.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM^hj hhubeh}(h]id26ah ]h"]h$] descriptionah&]uh1hhj hhhhhM\jKubh)}(hhh](h)}(hEXAMPLEh]hEXAMPLE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMcubj*)}(hX static size_t write (struct pardevice *dev, const void *buf, size_t len) { ... written = dev->port->ops->write_ecp_data (dev->port, buf, len); parport_release (dev); ... }h]hX static size_t write (struct pardevice *dev, const void *buf, size_t len) { ... written = dev->port->ops->write_ecp_data (dev->port, buf, len); parport_release (dev); ... }}hj$sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMghjhhubeh}(h]id27ah ]h"]h$]exampleah&]uh1hhj hhhhhMcjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hhhhhMsubh)}(hAchange_mode, parport_claim, parport_claim_or_block, parport_yieldh]hAchange_mode, parport_claim, parport_claim_or_block, parport_yield}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMuhj:hhubeh}(h]id28ah ]h"]h$]see alsoah&]uh1hhj hhhhhMsjKubeh}(h])parport-release-release-the-parallel-portah ]h"]+parport_release - release the parallel portah$]h&]uh1hhjqhhhhhMPubh)}(hhh](h)}(hKparport_yield, parport_yield_blocking - temporarily release a parallel porth]hKparport_yield, parport_yield_blocking - temporarily release a parallel port}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihhhhhMzubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhhhhhM}ubj*)}(hy#include int parport_yield (struct pardevice *dev) int parport_yield_blocking (struct pardevice *dev);h]hy#include int parport_yield (struct pardevice *dev) int parport_yield_blocking (struct pardevice *dev);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjzhhubeh}(h]id29ah ]h"]h$]synopsisah&]uh1hhjihhhhhM}jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hWhen a driver has control of a parallel port, it may allow another driver to temporarily ``borrow`` it. ``parport_yield`` does not block; ``parport_yield_blocking`` may do.h](hYWhen a driver has control of a parallel port, it may allow another driver to temporarily }(hjhhhNhNubj)}(h ``borrow``h]hborrow}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh it. }(hjhhhNhNubj)}(h``parport_yield``h]h parport_yield}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh does not block; }(hjhhhNhNubj)}(h``parport_yield_blocking``h]hparport_yield_blocking}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh may do.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id30ah ]h"]h$] descriptionah&]uh1hhjihhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(h`A return value of zero indicates that the caller still owns the port and the call did not block.h]h`A return value of zero indicates that the caller still owns the port and the call did not block.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(h{A positive return value from ``parport_yield_blocking`` indicates that the caller still owns the port and the call blocked.h](hA positive return value from }(hjhhhNhNubj)}(h``parport_yield_blocking``h]hparport_yield_blocking}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhD indicates that the caller still owns the port and the call blocked.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(hrA return value of -EAGAIN indicates that the caller no longer owns the port, and it must be re-claimed before use.h]hrA return value of -EAGAIN indicates that the caller no longer owns the port, and it must be re-claimed before use.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id31ah ]h"]h$] return valueah&]uh1hhjihhhhhMjKubh)}(hhh](h)}(hERRORSh]hERRORS}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShhhhhMubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jdhjgubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK:uh1jdhjgubj{)}(hhh]j)}(hhh](j)}(hhh]h)}(h-EAGAINh]h-EAGAIN}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h.Ownership of the parallel port was given away.h]h.Ownership of the parallel port was given away.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jzhjgubeh}(h]h ]h"]h$]h&]colsKuh1j_hjdubah}(h]h ]h"]h$]h&]uh1jZhjShhhhhNubeh}(h]id32ah ]h"]h$]errorsah&]uh1hhjihhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hparport_releaseh]hparport_release}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id33ah ]h"]h$]see alsoah&]uh1hhjihhhhhMjKubeh}(h]Hparport-yield-parport-yield-blocking-temporarily-release-a-parallel-portah ]h"]Kparport_yield, parport_yield_blocking - temporarily release a parallel portah$]h&]uh1hhjqhhhhhMzubh)}(hhh](h)}(h;parport_wait_peripheral - wait for status lines, up to 35msh]h;parport_wait_peripheral - wait for status lines, up to 35ms}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(h#include int parport_wait_peripheral (struct parport *port, unsigned char mask, unsigned char val);h]h#include int parport_wait_peripheral (struct parport *port, unsigned char mask, unsigned char val);}hj$sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id34ah ]h"]h$]synopsisah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj=hnhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hhhhhMubh)}(h=Wait for the status lines in mask to match the values in val.h]h=Wait for the status lines in mask to match the values in val.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj:hhubeh}(h]id35ah ]h"]h$] descriptionah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahhhhhMubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhjuubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK:uh1jdhjuubj{)}(hhh](j)}(hhh](j)}(hhh]h)}(h-EINTRh]h-EINTR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(ha signal is pendingh]ha signal is pending}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h+the status lines in mask have values in valh]h+the status lines in mask have values in val}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h&timed out while waiting (35ms elapsed)h]h&timed out while waiting (35ms elapsed)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jzhjuubeh}(h]h ]h"]h$]h&]colsKuh1j_hjrubah}(h]h ]h"]h$]h&]uh1jZhjahhhhhNubeh}(h]id36ah ]h"]h$] return valueah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhhhhhMubh)}(hparport_poll_peripheralh]hparport_poll_peripheral}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjOhhubeh}(h]id37ah ]h"]h$]see alsoah&]uh1hhjhhhhhMjKubeh}(h]8parport-wait-peripheral-wait-for-status-lines-up-to-35msah ]h"];parport_wait_peripheral - wait for status lines, up to 35msah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(h8parport_poll_peripheral - wait for status lines, in usech]h8parport_poll_peripheral - wait for status lines, in usec}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(h#include int parport_poll_peripheral (struct parport *port, unsigned char mask, unsigned char val, int usec);h]h#include int parport_poll_peripheral (struct parport *port, unsigned char mask, unsigned char val, int usec);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id38ah ]h"]h$]synopsisah&]uh1hhj~hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(h=Wait for the status lines in mask to match the values in val.h]h=Wait for the status lines in mask to match the values in val.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id39ah ]h"]h$] descriptionah&]uh1hhj~hhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhjubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK:uh1jdhjubj{)}(hhh](j)}(hhh](j)}(hhh]h)}(h-EINTRh]h-EINTR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(ha signal is pendingh]ha signal is pending}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj%ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hjh]h0}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjEubah}(h]h ]h"]h$]h&]uh1jhjBubj)}(hhh]h)}(h+the status lines in mask have values in valh]h+the status lines in mask have values in val}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj[ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hjh]h1}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj{ubah}(h]h ]h"]h$]h&]uh1jhjxubj)}(hhh]h)}(h8timed out while waiting (usec microseconds have elapsed)h]h8timed out while waiting (usec microseconds have elapsed)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jzhjubeh}(h]h ]h"]h$]h&]colsKuh1j_hjubah}(h]h ]h"]h$]h&]uh1jZhjhhhhhNubeh}(h]id40ah ]h"]h$] return valueah&]uh1hhj~hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hparport_wait_peripheralh]hparport_wait_peripheral}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id41ah ]h"]h$]see alsoah&]uh1hhj~hhhhhMjKubeh}(h]5parport-poll-peripheral-wait-for-status-lines-in-usecah ]h"]8parport_poll_peripheral - wait for status lines, in usecah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(h0parport_wait_event - wait for an event on a porth]h0parport_wait_event - wait for an event on a port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubj*)}(h^#include int parport_wait_event (struct parport *port, signed long timeout)h]h^#include int parport_wait_event (struct parport *port, signed long timeout)}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj hhubeh}(h]id42ah ]h"]h$]synopsisah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hhhhhMubh)}(hIWait for an event (e.g. interrupt) on a port. The timeout is in jiffies.h]hIWait for an event (e.g. interrupt) on a port. The timeout is in jiffies.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubeh}(h]id43ah ]h"]h$] descriptionah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhhhhhMubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhjkubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK:uh1jdhjkubj{)}(hhh](j)}(hhh](j)}(hhh]h)}(hjh]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hsuccessh]hsuccess}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h<0h]h<0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h error (exit as soon as possible)h]h error (exit as soon as possible)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h>0h]h>0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h timed outh]h timed out}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jzhjkubeh}(h]h ]h"]h$]h&]colsKuh1j_hjhubah}(h]h ]h"]h$]h&]uh1jZhjWhhhhhNubeh}(h]id44ah ]h"]h$] return valueah&]uh1hhjhhhhhMjKubeh}(h].parport-wait-event-wait-for-an-event-on-a-portah ]h"]0parport_wait_event - wait for an event on a portah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(h1parport_negotiate - perform IEEE 1284 negotiationh]h1parport_negotiate - perform IEEE 1284 negotiation}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhhhhhM ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hhhhhMubj*)}(hO#include int parport_negotiate (struct parport *, int mode);h]hO#include int parport_negotiate (struct parport *, int mode);}hjnsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj]hhubeh}(h]id45ah ]h"]h$]synopsisah&]uh1hhjLhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hPerform IEEE 1284 negotiation.h]hPerform IEEE 1284 negotiation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id46ah ]h"]h$] descriptionah&]uh1hhjLhhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhjubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK ssize_t parport_read (struct parport *, void *buf, size_t len);h]h[#include ssize_t parport_read (struct parport *, void *buf, size_t len);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM5hjhhubeh}(h]id49ah ]h"]h$]synopsisah&]uh1hhjhhhhhM1jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM:ubh)}(hxRead data from device in current IEEE 1284 transfer mode. This only works for modes that support reverse data transfer.h]hxRead data from device in current IEEE 1284 transfer mode. This only works for modes that support reverse data transfer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM<hjhhubeh}(h]id50ah ]h"]h$] descriptionah&]uh1hhjhhhhhM:jKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhM@ubh)}(hFIf negative, an error code; otherwise the number of bytes transferred.h]hFIf negative, an error code; otherwise the number of bytes transferred.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMBhj%hhubeh}(h]id51ah ]h"]h$] return valueah&]uh1hhjhhhhhM@jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhhhhhMEubh)}(h parport_write, parport_negotiateh]h parport_write, parport_negotiate}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMGhjLhhubeh}(h]id52ah ]h"]h$]see alsoah&]uh1hhjhhhhhMEjKubeh}(h]"parport-read-read-data-from-deviceah ]h"]$parport_read - read data from deviceah$]h&]uh1hhjqhhhhhM.ubh)}(hhh](h)}(h$parport_write - write data to deviceh]h$parport_write - write data to device}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hhhhhMLubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMOubj*)}(hb#include ssize_t parport_write (struct parport *, const void *buf, size_t len);h]hb#include ssize_t parport_write (struct parport *, const void *buf, size_t len);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMShjhhubeh}(h]id53ah ]h"]h$]synopsisah&]uh1hhj{hhhhhMOjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMXubh)}(hwWrite data to device in current IEEE 1284 transfer mode. This only works for modes that support forward data transfer.h]hwWrite data to device in current IEEE 1284 transfer mode. This only works for modes that support forward data transfer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMZhjhhubeh}(h]id54ah ]h"]h$] descriptionah&]uh1hhj{hhhhhMXjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM^ubh)}(hFIf negative, an error code; otherwise the number of bytes transferred.h]hFIf negative, an error code; otherwise the number of bytes transferred.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM`hjhhubeh}(h]id55ah ]h"]h$] return valueah&]uh1hhj{hhhhhM^jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMcubh)}(hparport_read, parport_negotiateh]hparport_read, parport_negotiate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMehjhhubeh}(h]id56ah ]h"]h$]see alsoah&]uh1hhj{hhhhhMcjKubeh}(h]"parport-write-write-data-to-deviceah ]h"]$parport_write - write data to deviceah$]h&]uh1hhjqhhhhhMLubh)}(hhh](h)}(h;parport_open - register device for particular device numberh]h;parport_open - register device for particular device number}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hhhhhMkubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhhhhhMnubj*)}(hXx#include struct pardevice *parport_open (int devnum, const char *name, int (*pf) (void *), void (*kf) (void *), void (*irqf) (int, void *, struct pt_regs *), int flags, void *handle);h]hXx#include struct pardevice *parport_open (int devnum, const char *name, int (*pf) (void *), void (*kf) (void *), void (*irqf) (int, void *, struct pt_regs *), int flags, void *handle);}hjRsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMrhjAhhubeh}(h]id57ah ]h"]h$]synopsisah&]uh1hhj0hhhhhMnjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhhM|ubh)}(hhThis is like parport_register_device but takes a device number instead of a pointer to a struct parport.h]hhThis is like parport_register_device but takes a device number instead of a pointer to a struct parport.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM~hjhhhubeh}(h]id58ah ]h"]h$] descriptionah&]uh1hhj0hhhhhM|jKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hWSee parport_register_device. If no device is associated with devnum, NULL is returned.h]hWSee parport_register_device. If no device is associated with devnum, NULL is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id59ah ]h"]h$] return valueah&]uh1hhj0hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hparport_register_deviceh]hparport_register_device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id60ah ]h"]h$]see alsoah&]uh1hhj0hhhhhMjKubeh}(h]9parport-open-register-device-for-particular-device-numberah ]h"];parport_open - register device for particular device numberah$]h&]uh1hhjqhhhhhMkubh)}(hhh](h)}(h>parport_close - unregister device for particular device numberh]h>parport_close - unregister device for particular device number}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(hG#include void parport_close (struct pardevice *dev);h]hG#include void parport_close (struct pardevice *dev);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id61ah ]h"]h$]synopsisah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hEThis is the equivalent of parport_unregister_device for parport_open.h]hEThis is the equivalent of parport_unregister_device for parport_open.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id62ah ]h"]h$] descriptionah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhhhhhMubh)}(h'parport_unregister_device, parport_openh]h'parport_unregister_device, parport_open}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjDhhubeh}(h]id63ah ]h"]h$]see alsoah&]uh1hhjhhhhhMjKubeh}(h]parport_close - unregister device for particular device numberah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(h.parport_device_id - obtain IEEE 1284 Device IDh]h.parport_device_id - obtain IEEE 1284 Device ID}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(h]#include ssize_t parport_device_id (int devnum, char *buffer, size_t len);h]h]#include ssize_t parport_device_id (int devnum, char *buffer, size_t len);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id64ah ]h"]h$]synopsisah&]uh1hhjshhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(h?Obtains the IEEE 1284 Device ID associated with a given device.h]h?Obtains the IEEE 1284 Device ID associated with a given device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id65ah ]h"]h$] descriptionah&]uh1hhjshhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hIf negative, an error code; otherwise, the number of bytes of buffer that contain the device ID. The format of the device ID is as follows::h]hIf negative, an error code; otherwise, the number of bytes of buffer that contain the device ID. The format of the device ID is as follows:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj*)}(h [length][ID]h]h [length][ID]}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubh)}(hThe first two bytes indicate the inclusive length of the entire Device ID, and are in big-endian order. The ID is a sequence of pairs of the form::h]hThe first two bytes indicate the inclusive length of the entire Device ID, and are in big-endian order. The ID is a sequence of pairs of the form:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj*)}(h key:value;h]h key:value;}hj sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id66ah ]h"]h$] return valueah&]uh1hhjshhhhhMjKubh)}(hhh](h)}(hNOTESh]hNOTES}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hhhhhMubh)}(h2Many devices have ill-formed IEEE 1284 Device IDs.h]h2Many devices have ill-formed IEEE 1284 Device IDs.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#hhubeh}(h]id67ah ]h"]h$]jah&]uh1hhjshhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhhhhhMubh)}(h'parport_find_class, parport_find_deviceh]h'parport_find_class, parport_find_device}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjIhhubeh}(h]id68ah ]h"]h$]see alsoah&]uh1hhjshhhhhMjKubeh}(h],parport-device-id-obtain-ieee-1284-device-idah ]h"].parport_device_id - obtain ieee 1284 device idah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(hCparport_device_coords - convert device number to device coordinatesh]hCparport_device_coords - convert device number to device coordinates}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjxhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(h#include int parport_device_coords (int devnum, int *parport, int *mux, int *daisy);h]h#include int parport_device_coords (int devnum, int *parport, int *mux, int *daisy);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id69ah ]h"]h$]synopsisah&]uh1hhjxhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hkConvert between device number (zero-based) and device coordinates (port, multiplexor, daisy chain address).h]hkConvert between device number (zero-based) and device coordinates (port, multiplexor, daisy chain address).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id70ah ]h"]h$] descriptionah&]uh1hhjxhhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hXZero on success, in which case the coordinates are (``*parport``, ``*mux``, ``*daisy``).h](h4Zero on success, in which case the coordinates are (}(hjhhhNhNubj)}(h ``*parport``h]h*parport}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }(hjhhhNhNubj)}(h``*mux``h]h*mux}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }(hjhhhNhNubj)}(h ``*daisy``h]h*daisy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id71ah ]h"]h$] return valueah&]uh1hhjxhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hhhhhMubh)}(hparport_open, parport_device_idh]hparport_open, parport_device_id}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj4hhubeh}(h]id72ah ]h"]h$]see alsoah&]uh1hhjxhhhhhMjKubeh}(h]Aparport-device-coords-convert-device-number-to-device-coordinatesah ]h"]Cparport_device_coords - convert device number to device coordinatesah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(h/parport_find_class - find a device by its classh]h/parport_find_class - find a device by its class}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthhhhhMubj*)}(hX#include typedef enum { PARPORT_CLASS_LEGACY = 0, /* Non-IEEE1284 device */ PARPORT_CLASS_PRINTER, PARPORT_CLASS_MODEM, PARPORT_CLASS_NET, PARPORT_CLASS_HDC, /* Hard disk controller */ PARPORT_CLASS_PCMCIA, PARPORT_CLASS_MEDIA, /* Multimedia device */ PARPORT_CLASS_FDC, /* Floppy disk controller */ PARPORT_CLASS_PORTS, PARPORT_CLASS_SCANNER, PARPORT_CLASS_DIGCAM, PARPORT_CLASS_OTHER, /* Anything else */ PARPORT_CLASS_UNSPEC, /* No CLS field in ID */ PARPORT_CLASS_SCSIADAPTER } parport_device_class; int parport_find_class (parport_device_class cls, int from);h]hX#include typedef enum { PARPORT_CLASS_LEGACY = 0, /* Non-IEEE1284 device */ PARPORT_CLASS_PRINTER, PARPORT_CLASS_MODEM, PARPORT_CLASS_NET, PARPORT_CLASS_HDC, /* Hard disk controller */ PARPORT_CLASS_PCMCIA, PARPORT_CLASS_MEDIA, /* Multimedia device */ PARPORT_CLASS_FDC, /* Floppy disk controller */ PARPORT_CLASS_PORTS, PARPORT_CLASS_SCANNER, PARPORT_CLASS_DIGCAM, PARPORT_CLASS_OTHER, /* Anything else */ PARPORT_CLASS_UNSPEC, /* No CLS field in ID */ PARPORT_CLASS_SCSIADAPTER } parport_device_class; int parport_find_class (parport_device_class cls, int from);}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjthhubeh}(h]id73ah ]h"]h$]synopsisah&]uh1hhjchhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hEFind a device by class. The search starts from device number from+1.h]hEFind a device by class. The search starts from device number from+1.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id74ah ]h"]h$] descriptionah&]uh1hhjchhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hSThe device number of the next device in that class, or -1 if no such device exists.h]hSThe device number of the next device in that class, or -1 if no such device exists.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id75ah ]h"]h$] return valueah&]uh1hhjchhhhhMjKubh)}(hhh](h)}(hNOTESh]hNOTES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hExample usage::h]hExample usage:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj*)}(hint devnum = -1; while ((devnum = parport_find_class (PARPORT_CLASS_DIGCAM, devnum)) != -1) { struct pardevice *dev = parport_open (devnum, ...); ... }h]hint devnum = -1; while ((devnum = parport_find_class (PARPORT_CLASS_DIGCAM, devnum)) != -1) { struct pardevice *dev = parport_open (devnum, ...); ... }}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id76ah ]h"]h$]notesah&]uh1hhjchhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM&ubh)}(h4parport_find_device, parport_open, parport_device_idh]h4parport_find_device, parport_open, parport_device_id}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM(hjhhubeh}(h]id77ah ]h"]h$]see alsoah&]uh1hhjchhhhhM&jKubeh}(h]-parport-find-class-find-a-device-by-its-classah ]h"]/parport_find_class - find a device by its classah$]h&]uh1hhjqhhhhhMubh)}(hhh](h)}(h0parport_find_device - find a device by its classh]h0parport_find_device - find a device by its class}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhhhhhM-ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hhhhhM0ubj*)}(ha#include int parport_find_device (const char *mfg, const char *mdl, int from);h]ha#include int parport_find_device (const char *mfg, const char *mdl, int from);}hjosbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM4hj^hhubeh}(h]id78ah ]h"]h$]synopsisah&]uh1hhjMhhhhhM0jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM9ubh)}(hPFind a device by vendor and model. The search starts from device number from+1.h]hPFind a device by vendor and model. The search starts from device number from+1.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM;hjhhubeh}(h]id79ah ]h"]h$] descriptionah&]uh1hhjMhhhhhM9jKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhM?ubh)}(haThe device number of the next device matching the specifications, or -1 if no such device exists.h]haThe device number of the next device matching the specifications, or -1 if no such device exists.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMAhjhhubeh}(h]id80ah ]h"]h$] return valueah&]uh1hhjMhhhhhM?jKubh)}(hhh](h)}(hNOTESh]hNOTES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMEubh)}(hExample usage::h]hExample usage:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMGhjhhubj*)}(hint devnum = -1; while ((devnum = parport_find_device ("IOMEGA", "ZIP+", devnum)) != -1) { struct pardevice *dev = parport_open (devnum, ...); ... }h]hint devnum = -1; while ((devnum = parport_find_device ("IOMEGA", "ZIP+", devnum)) != -1) { struct pardevice *dev = parport_open (devnum, ...); ... }}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMIhjhhubeh}(h]id81ah ]h"]h$]notesah&]uh1hhjMhhhhhMEjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMPubh)}(h3parport_find_class, parport_open, parport_device_idh]h3parport_find_class, parport_open, parport_device_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMRhjhhubeh}(h]id82ah ]h"]h$]see alsoah&]uh1hhjMhhhhhMPjKubeh}(h].parport-find-device-find-a-device-by-its-classah ]h"]0parport_find_device - find a device by its classah$]h&]uh1hhjqhhhhhM-ubh)}(hhh](h)}(h0parport_set_timeout - set the inactivity timeouth]h0parport_set_timeout - set the inactivity timeout}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hhhhhMXubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhhhhhM[ubj*)}(h^#include long parport_set_timeout (struct pardevice *dev, long inactivity);h]h^#include long parport_set_timeout (struct pardevice *dev, long inactivity);}hjYsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM_hjHhhubeh}(h]id83ah ]h"]h$]synopsisah&]uh1hhj7hhhhhM[jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohhhhhMdubh)}(hcSet the inactivity timeout, in jiffies, for a registered device. The previous timeout is returned.h]hcSet the inactivity timeout, in jiffies, for a registered device. The previous timeout is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMfhjohhubeh}(h]id84ah ]h"]h$] descriptionah&]uh1hhj7hhhhhMdjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMjubh)}(h!The previous timeout, in jiffies.h]h!The previous timeout, in jiffies.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMlhjhhubeh}(h]id85ah ]h"]h$] return valueah&]uh1hhj7hhhhhMjjKubh)}(hhh](h)}(hNOTESh]hNOTES}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMoubh)}(hSome of the port->ops functions for a parport may take time, owing to delays at the peripheral. After the peripheral has not responded for ``inactivity`` jiffies, a timeout will occur and the blocking function will return.h](hSome of the port->ops functions for a parport may take time, owing to delays at the peripheral. After the peripheral has not responded for }(hjhhhNhNubj)}(h``inactivity``h]h inactivity}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhE jiffies, a timeout will occur and the blocking function will return.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMqhjhhubh)}(hXA timeout of 0 jiffies is a special case: the function must do as much as it can without blocking or leaving the hardware in an unknown state. If port operations are performed from within an interrupt handler, for instance, a timeout of 0 jiffies should be used.h]hXA timeout of 0 jiffies is a special case: the function must do as much as it can without blocking or leaving the hardware in an unknown state. If port operations are performed from within an interrupt handler, for instance, a timeout of 0 jiffies should be used.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMvhjhhubh)}(h[Once set for a registered device, the timeout will remain at the set value until set again.h]h[Once set for a registered device, the timeout will remain at the set value until set again.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM{hjhhubeh}(h]id86ah ]h"]h$]notesah&]uh1hhj7hhhhhMojKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hport->ops->xxx_read/write_yyyh]hport->ops->xxx_read/write_yyy}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id87ah ]h"]h$]see alsoah&]uh1hhj7hhhhhMjKubeh}(h].parport-set-timeout-set-the-inactivity-timeoutah ]h"]0parport_set_timeout - set the inactivity timeoutah$]h&]uh1hhjqhhhhhMXubeh}(h]global-functionsah ]h"]global functionsah$]h&]uh1hhhhhhhhKkubh)}(hhh](h)}(hPORT FUNCTIONSh]hPORT FUNCTIONS}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhhhhhMubh)}(hThe functions in the port->ops structure (struct parport_operations) are provided by the low-level driver responsible for that port.h]hThe functions in the port->ops structure (struct parport_operations) are provided by the low-level driver responsible for that port.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjIhhubh)}(hhh](h)}(h-port->ops->read_data - read the data registerh]h-port->ops->read_data - read the data register}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyhhhhhMubj*)}(h#include struct parport_operations { ... unsigned char (*read_data) (struct parport *port); ... };h]h#include struct parport_operations { ... unsigned char (*read_data) (struct parport *port); ... };}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjyhhubeh}(h]id88ah ]h"]h$]synopsisah&]uh1hhjhhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hXIf port->modes contains the PARPORT_MODE_TRISTATE flag and the PARPORT_CONTROL_DIRECTION bit in the control register is set, this returns the value on the data pins. If port->modes contains the PARPORT_MODE_TRISTATE flag and the PARPORT_CONTROL_DIRECTION bit is not set, the return value _may_ be the last value written to the data register. Otherwise the return value is undefined.h]hXIf port->modes contains the PARPORT_MODE_TRISTATE flag and the PARPORT_CONTROL_DIRECTION bit in the control register is set, this returns the value on the data pins. If port->modes contains the PARPORT_MODE_TRISTATE flag and the PARPORT_CONTROL_DIRECTION bit is not set, the return value _may_ be the last value written to the data register. Otherwise the return value is undefined.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id89ah ]h"]h$] descriptionah&]uh1hhjhhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(h&write_data, read_status, write_controlh]h&write_data, read_status, write_control}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id90ah ]h"]h$]see alsoah&]uh1hhjhhhhhhMjKubeh}(h])port-ops-read-data-read-the-data-registerah ]h"]-port->ops->read_data - read the data registerah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h/port->ops->write_data - write the data registerh]h/port->ops->write_data - write the data register}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(h#include struct parport_operations { ... void (*write_data) (struct parport *port, unsigned char d); ... };h]h#include struct parport_operations { ... void (*write_data) (struct parport *port, unsigned char d); ... };}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id91ah ]h"]h$]synopsisah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hhhhhMubh)}(hSWrites to the data register. May have side-effects (a STROBE pulse, for instance).h]hSWrites to the data register. May have side-effects (a STROBE pulse, for instance).}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj.hhubeh}(h]id92ah ]h"]h$] descriptionah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhhhhhMubh)}(h%read_data, read_status, write_controlh]h%read_data, read_status, write_control}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjUhhubeh}(h]id93ah ]h"]h$]see alsoah&]uh1hhjhhhhhMjKubeh}(h]+port-ops-write-data-write-the-data-registerah ]h"]/port->ops->write_data - write the data registerah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h1port->ops->read_status - read the status registerh]h1port->ops->read_status - read the status register}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(h#include struct parport_operations { ... unsigned char (*read_status) (struct parport *port); ... };h]h#include struct parport_operations { ... unsigned char (*read_status) (struct parport *port); ... };}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id94ah ]h"]h$]synopsisah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(h3Reads from the status register. This is a bitmask:h]h3Reads from the status register. This is a bitmask:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh bullet_list)}(hhh](h list_item)}(h.PARPORT_STATUS_ERROR (printer fault, "nFault")h]h)}(hjh]h2PARPORT_STATUS_ERROR (printer fault, “nFault”)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h)PARPORT_STATUS_SELECT (on-line, "Select")h]h)}(hjh]h-PARPORT_STATUS_SELECT (on-line, “Select”)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h,PARPORT_STATUS_PAPEROUT (no paper, "PError")h]h)}(hjh]h0PARPORT_STATUS_PAPEROUT (no paper, “PError”)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h&PARPORT_STATUS_ACK (handshake, "nAck")h]h)}(hj)h]h*PARPORT_STATUS_ACK (handshake, “nAck”)}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj'ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h#PARPORT_STATUS_BUSY (busy, "Busy") h]h)}(h"PARPORT_STATUS_BUSY (busy, "Busy")h]h&PARPORT_STATUS_BUSY (busy, “Busy”)}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj>ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhMhjhhubh)}(hThere may be other bits set.h]hThere may be other bits set.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id95ah ]h"]h$] descriptionah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthhhhhMubh)}(h$read_data, write_data, write_controlh]h$read_data, write_data, write_control}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjthhubeh}(h]id96ah ]h"]h$]see alsoah&]uh1hhjhhhhhMjKubeh}(h]-port-ops-read-status-read-the-status-registerah ]h"]1port->ops->read_status - read the status registerah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h3port->ops->read_control - read the control registerh]h3port->ops->read_control - read the control register}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj*)}(h#include struct parport_operations { ... unsigned char (*read_control) (struct parport *port); ... };h]h#include struct parport_operations { ... unsigned char (*read_control) (struct parport *port); ... };}hjsbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjhhubeh}(h]id97ah ]h"]h$]synopsisah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hReturns the last value written to the control register (either from write_control or frob_control). No port access is performed.h]hReturns the last value written to the control register (either from write_control or frob_control). No port access is performed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id98ah ]h"]h$] descriptionah&]uh1hhjhhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(h1read_data, write_data, read_status, write_controlh]h1read_data, write_data, read_status, write_control}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj hhubeh}(h]id99ah ]h"]h$]see alsoah&]uh1hhjhhhhhMjKubeh}(h]/port-ops-read-control-read-the-control-registerah ]h"]3port->ops->read_control - read the control registerah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h5port->ops->write_control - write the control registerh]h5port->ops->write_control - write the control register}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1 hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjE hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjB hhhhhMubj*)}(h#include struct parport_operations { ... void (*write_control) (struct parport *port, unsigned char s); ... };h]h#include struct parport_operations { ... void (*write_control) (struct parport *port, unsigned char s); ... };}hjS sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhjB hhubeh}(h]id100ah ]h"]h$]synopsisah&]uh1hhj1 hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1hhji hhhhhM ubh)}(h3Writes to the control register. This is a bitmask::h]h2Writes to the control register. This is a bitmask:}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM"hji hhubj*)}(hX _______ - PARPORT_CONTROL_STROBE (nStrobe) _______ - PARPORT_CONTROL_AUTOFD (nAutoFd) _____ - PARPORT_CONTROL_INIT (nInit) _________ - PARPORT_CONTROL_SELECT (nSelectIn)h]hX _______ - PARPORT_CONTROL_STROBE (nStrobe) _______ - PARPORT_CONTROL_AUTOFD (nAutoFd) _____ - PARPORT_CONTROL_INIT (nInit) _________ - PARPORT_CONTROL_SELECT (nSelectIn)}hj sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM$hji hhubeh}(h]id101ah ]h"]h$] descriptionah&]uh1hhj1 hhhhhM jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM.ubh)}(h0read_data, write_data, read_status, frob_controlh]h0read_data, write_data, read_status, frob_control}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM0hj hhubeh}(h]id102ah ]h"]h$]see alsoah&]uh1hhj1 hhhhhM.jKubeh}(h]1port-ops-write-control-write-the-control-registerah ]h"]5port->ops->write_control - write the control registerah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h5port->ops->frob_control - write control register bitsh]h5port->ops->frob_control - write control register bits}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM6ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM9ubj*)}(h#include struct parport_operations { ... unsigned char (*frob_control) (struct parport *port, unsigned char mask, unsigned char val); ... };h]h#include struct parport_operations { ... unsigned char (*frob_control) (struct parport *port, unsigned char mask, unsigned char val); ... };}hj sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM=hj hhubeh}(h]id103ah ]h"]h$]synopsisah&]uh1hhj hhhhhM9jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hhhhhMHubh)}(hThis is equivalent to reading from the control register, masking out the bits in mask, exclusive-or'ing with the bits in val, and writing the result to the control register.h]hThis is equivalent to reading from the control register, masking out the bits in mask, exclusive-or’ing with the bits in val, and writing the result to the control register.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMJhj!hhubh)}(hAs some ports don't allow reads from the control port, a software copy of its contents is maintained, so frob_control is in fact only one port access.h]hAs some ports don’t allow reads from the control port, a software copy of its contents is maintained, so frob_control is in fact only one port access.}(hj$!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMNhj!hhubeh}(h]id104ah ]h"]h$] descriptionah&]uh1hhj hhhhhMHjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj=!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:!hhhhhMSubh)}(h1read_data, write_data, read_status, write_controlh]h1read_data, write_data, read_status, write_control}(hjK!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMUhj:!hhubeh}(h]id105ah ]h"]h$]see alsoah&]uh1hhj hhhhhMSjKubeh}(h]1port-ops-frob-control-write-control-register-bitsah ]h"]5port->ops->frob_control - write control register bitsah$]h&]uh1hhjIhhhhhM6ubh)}(hhh](h)}(h3port->ops->enable_irq - enable interrupt generationh]h3port->ops->enable_irq - enable interrupt generation}(hjl!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhji!hhhhhM[ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj}!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjz!hhhhhM^ubj*)}(h#include struct parport_operations { ... void (*enable_irq) (struct parport *port); ... };h]h#include struct parport_operations { ... void (*enable_irq) (struct parport *port); ... };}hj!sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMbhjz!hhubeh}(h]id106ah ]h"]h$]synopsisah&]uh1hhji!hhhhhM^jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hhhhhMkubh)}(hThe parallel port hardware is instructed to generate interrupts at appropriate moments, although those moments are architecture-specific. For the PC architecture, interrupts are commonly generated on the rising edge of nAck.h]hThe parallel port hardware is instructed to generate interrupts at appropriate moments, although those moments are architecture-specific. For the PC architecture, interrupts are commonly generated on the rising edge of nAck.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMmhj!hhubeh}(h]id107ah ]h"]h$] descriptionah&]uh1hhji!hhhhhMkjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hhhhhMsubh)}(h disable_irqh]h disable_irq}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMuhj!hhubeh}(h]id108ah ]h"]h$]see alsoah&]uh1hhji!hhhhhMsjKubeh}(h]/port-ops-enable-irq-enable-interrupt-generationah ]h"]3port->ops->enable_irq - enable interrupt generationah$]h&]uh1hhjIhhhhhM[ubh)}(hhh](h)}(h5port->ops->disable_irq - disable interrupt generationh]h5port->ops->disable_irq - disable interrupt generation}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hhhhhM{ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj "hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hhhhhM~ubj*)}(h#include struct parport_operations { ... void (*disable_irq) (struct parport *port); ... };h]h#include struct parport_operations { ... void (*disable_irq) (struct parport *port); ... };}hj"sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj"hhubeh}(h]id109ah ]h"]h$]synopsisah&]uh1hhj!hhhhhM~jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj2"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/"hhhhhMubh)}(hhThe parallel port hardware is instructed not to generate interrupts. The interrupt itself is not masked.h]hhThe parallel port hardware is instructed not to generate interrupts. The interrupt itself is not masked.}(hj@"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj/"hhubeh}(h]id110ah ]h"]h$] descriptionah&]uh1hhj!hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjY"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjV"hhhhhMubh)}(h enable_irqh]h enable_irq}(hjg"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjV"hhubeh}(h]id111ah ]h"]h$]see alsoah&]uh1hhj!hhhhhMjKubeh}(h]1port-ops-disable-irq-disable-interrupt-generationah ]h"]5port->ops->disable_irq - disable interrupt generationah$]h&]uh1hhjIhhhhhM{ubh)}(hhh](h)}(h-port->ops->data_forward - enable data driversh]h-port->ops->data_forward - enable data drivers}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hhhhhMubj*)}(h#include struct parport_operations { ... void (*data_forward) (struct parport *port); ... };h]h#include struct parport_operations { ... void (*data_forward) (struct parport *port); ... };}hj"sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj"hhubeh}(h]id112ah ]h"]h$]synopsisah&]uh1hhj"hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hhhhhMubh)}(hKEnables the data line drivers, for 8-bit host-to-peripheral communications.h]hKEnables the data line drivers, for 8-bit host-to-peripheral communications.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"hhubeh}(h]id113ah ]h"]h$] descriptionah&]uh1hhj"hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hhhhhMubh)}(h data_reverseh]h data_reverse}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"hhubeh}(h]id114ah ]h"]h$]see alsoah&]uh1hhj"hhhhhMjKubeh}(h])port-ops-data-forward-enable-data-driversah ]h"]-port->ops->data_forward - enable data driversah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h-port->ops->data_reverse - tristate the bufferh]h-port->ops->data_reverse - tristate the buffer}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj'#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$#hhhhhMubj*)}(h#include struct parport_operations { ... void (*data_reverse) (struct parport *port); ... };h]h#include struct parport_operations { ... void (*data_reverse) (struct parport *port); ... };}hj5#sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj$#hhubeh}(h]id115ah ]h"]h$]synopsisah&]uh1hhj#hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjN#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjK#hhhhhMubh)}(hdPlaces the data bus in a high impedance state, if port->modes has the PARPORT_MODE_TRISTATE bit set.h]hdPlaces the data bus in a high impedance state, if port->modes has the PARPORT_MODE_TRISTATE bit set.}(hj\#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjK#hhubeh}(h]id116ah ]h"]h$] descriptionah&]uh1hhj#hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hju#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjr#hhhhhMubh)}(h data_forwardh]h data_forward}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjr#hhubeh}(h]id117ah ]h"]h$]see alsoah&]uh1hhj#hhhhhMjKubeh}(h])port-ops-data-reverse-tristate-the-bufferah ]h"]-port->ops->data_reverse - tristate the bufferah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h*port->ops->epp_write_data - write EPP datah]h*port->ops->epp_write_data - write EPP data}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hhhhhMubj*)}(h#include struct parport_operations { ... size_t (*epp_write_data) (struct parport *port, const void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*epp_write_data) (struct parport *port, const void *buf, size_t len, int flags); ... };}hj#sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj#hhubeh}(h]id118ah ]h"]h$]synopsisah&]uh1hhj#hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hhhhhMubh)}(hAWrites data in EPP mode, and returns the number of bytes written.h]hAWrites data in EPP mode, and returns the number of bytes written.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj#hhubh)}(hTThe ``flags`` parameter may be one or more of the following, bitwise-or'ed together:h](hThe }(hj#hhhNhNubj)}(h ``flags``h]hflags}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubhI parameter may be one or more of the following, bitwise-or’ed together:}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj#hhubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhj$ubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK1uh1jdhj$ubj{)}(hhh]j)}(hhh](j)}(hhh]h)}(hPARPORT_EPP_FASTh]hPARPORT_EPP_FAST}(hj;$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj8$ubah}(h]h ]h"]h$]h&]uh1jhj5$ubj)}(hhh]h)}(hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.h]hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.}(hjR$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjO$ubah}(h]h ]h"]h$]h&]uh1jhj5$ubeh}(h]h ]h"]h$]h&]uh1jhj2$ubah}(h]h ]h"]h$]h&]uh1jzhj$ubeh}(h]h ]h"]h$]h&]colsKuh1j_hj$ubah}(h]h ]h"]h$]h&]uh1jZhj#hhhhhNubeh}(h]id119ah ]h"]h$] descriptionah&]uh1hhj#hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hhhhhMubh)}(h,epp_read_data, epp_write_addr, epp_read_addrh]h,epp_read_data, epp_write_addr, epp_read_addr}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubeh}(h]id120ah ]h"]h$]see alsoah&]uh1hhj#hhhhhMjKubeh}(h]&port-ops-epp-write-data-write-epp-dataah ]h"]*port->ops->epp_write_data - write epp dataah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h(port->ops->epp_read_data - read EPP datah]h(port->ops->epp_read_data - read EPP data}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hhhhhMubj*)}(h#include struct parport_operations { ... size_t (*epp_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*epp_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };}hj$sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj$hhubeh}(h]id121ah ]h"]h$]synopsisah&]uh1hhj$hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hhhhhM ubh)}(h=Reads data in EPP mode, and returns the number of bytes read.h]h=Reads data in EPP mode, and returns the number of bytes read.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubh)}(hTThe ``flags`` parameter may be one or more of the following, bitwise-or'ed together:h](hThe }(hj %hhhNhNubj)}(h ``flags``h]hflags}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj %ubhI parameter may be one or more of the following, bitwise-or’ed together:}(hj %hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj$hhubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhj0%ubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK1uh1jdhj0%ubj{)}(hhh]j)}(hhh](j)}(hhh]h)}(hPARPORT_EPP_FASTh]hPARPORT_EPP_FAST}(hjP%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjM%ubah}(h]h ]h"]h$]h&]uh1jhjJ%ubj)}(hhh]h)}(hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.h]hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.}(hjg%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjd%ubah}(h]h ]h"]h$]h&]uh1jhjJ%ubeh}(h]h ]h"]h$]h&]uh1jhjG%ubah}(h]h ]h"]h$]h&]uh1jzhj0%ubeh}(h]h ]h"]h$]h&]colsKuh1j_hj-%ubah}(h]h ]h"]h$]h&]uh1jZhj$hhhhhNubeh}(h]id122ah ]h"]h$] descriptionah&]uh1hhj$hhhhhM jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhMubh)}(h-epp_write_data, epp_write_addr, epp_read_addrh]h-epp_write_data, epp_write_addr, epp_read_addr}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj%hhubeh}(h]id123ah ]h"]h$]see alsoah&]uh1hhj$hhhhhMjKubeh}(h]$port-ops-epp-read-data-read-epp-dataah ]h"](port->ops->epp_read_data - read epp dataah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h-port->ops->epp_write_addr - write EPP addressh]h-port->ops->epp_write_addr - write EPP address}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhM!ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhM$ubj*)}(h#include struct parport_operations { ... size_t (*epp_write_addr) (struct parport *port, const void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*epp_write_addr) (struct parport *port, const void *buf, size_t len, int flags); ... };}hj%sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM(hj%hhubeh}(h]id124ah ]h"]h$]synopsisah&]uh1hhj%hhhhhM$jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hhhhhM2ubh)}(hCWrites EPP addresses (8 bits each), and returns the number written.h]hCWrites EPP addresses (8 bits each), and returns the number written.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM4hj&hhubh)}(hTThe ``flags`` parameter may be one or more of the following, bitwise-or'ed together:h](hThe }(hj"&hhhNhNubj)}(h ``flags``h]hflags}(hj*&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"&ubhI parameter may be one or more of the following, bitwise-or’ed together:}(hj"&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM6hj&hhubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhjE&ubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK1uh1jdhjE&ubj{)}(hhh]j)}(hhh](j)}(hhh]h)}(hPARPORT_EPP_FASTh]hPARPORT_EPP_FAST}(hje&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM:hjb&ubah}(h]h ]h"]h$]h&]uh1jhj_&ubj)}(hhh]h)}(hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.h]hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.}(hj|&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM:hjy&ubah}(h]h ]h"]h$]h&]uh1jhj_&ubeh}(h]h ]h"]h$]h&]uh1jhj\&ubah}(h]h ]h"]h$]h&]uh1jzhjE&ubeh}(h]h ]h"]h$]h&]colsKuh1j_hjB&ubah}(h]h ]h"]h$]h&]uh1jZhj&hhhhhNubh)}(h5(Does PARPORT_EPP_FAST make sense for this function?)h]h5(Does PARPORT_EPP_FAST make sense for this function?)}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM?hj&hhubeh}(h]id125ah ]h"]h$] descriptionah&]uh1hhj%hhhhhM2jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hhhhhMBubh)}(h,epp_write_data, epp_read_data, epp_read_addrh]h,epp_write_data, epp_read_data, epp_read_addr}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhj&hhubeh}(h]id126ah ]h"]h$]see alsoah&]uh1hhj%hhhhhMBjKubeh}(h])port-ops-epp-write-addr-write-epp-addressah ]h"]-port->ops->epp_write_addr - write epp addressah$]h&]uh1hhjIhhhhhM!ubh)}(hhh](h)}(h+port->ops->epp_read_addr - read EPP addressh]h+port->ops->epp_read_addr - read EPP address}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hhhhhMJubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hhhhhMMubj*)}(h#include struct parport_operations { ... size_t (*epp_read_addr) (struct parport *port, void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*epp_read_addr) (struct parport *port, void *buf, size_t len, int flags); ... };}hj'sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMQhj&hhubeh}(h]id127ah ]h"]h$]synopsisah&]uh1hhj&hhhhhMMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj)'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&'hhhhhM[ubh)}(h?Reads EPP addresses (8 bits each), and returns the number read.h]h?Reads EPP addresses (8 bits each), and returns the number read.}(hj7'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM]hj&'hhubh)}(hTThe ``flags`` parameter may be one or more of the following, bitwise-or'ed together:h](hThe }(hjE'hhhNhNubj)}(h ``flags``h]hflags}(hjM'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE'ubhI parameter may be one or more of the following, bitwise-or’ed together:}(hjE'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM_hj&'hhubj[)}(hhh]j`)}(hhh](je)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jdhjh'ubje)}(hhh]h}(h]h ]h"]h$]h&]colwidthK1uh1jdhjh'ubj{)}(hhh]j)}(hhh](j)}(hhh]h)}(hPARPORT_EPP_FASTh]hPARPORT_EPP_FAST}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMchj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubj)}(hhh]h)}(hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.h]hUse fast transfers. Some chips provide 16-bit and 32-bit registers. However, if a transfer times out, the return value may be unreliable.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMchj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jzhjh'ubeh}(h]h ]h"]h$]h&]colsKuh1j_hje'ubah}(h]h ]h"]h$]h&]uh1jZhj&'hhhhhNubh)}(h5(Does PARPORT_EPP_FAST make sense for this function?)h]h5(Does PARPORT_EPP_FAST make sense for this function?)}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhhj&'hhubeh}(h]id128ah ]h"]h$] descriptionah&]uh1hhj&hhhhhM[jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hhhhhMkubh)}(h-epp_write_data, epp_read_data, epp_write_addrh]h-epp_write_data, epp_read_data, epp_write_addr}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMmhj'hhubeh}(h]id129ah ]h"]h$]see alsoah&]uh1hhj&hhhhhMkjKubeh}(h]'port-ops-epp-read-addr-read-epp-addressah ]h"]+port->ops->epp_read_addr - read epp addressah$]h&]uh1hhjIhhhhhMJubh)}(hhh](h)}(h5port->ops->ecp_write_data - write a block of ECP datah]h5port->ops->ecp_write_data - write a block of ECP data}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hhhhhMsubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj%(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"(hhhhhMvubj*)}(h#include struct parport_operations { ... size_t (*ecp_write_data) (struct parport *port, const void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*ecp_write_data) (struct parport *port, const void *buf, size_t len, int flags); ... };}hj3(sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMzhj"(hhubeh}(h]id130ah ]h"]h$]synopsisah&]uh1hhj(hhhhhMvjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjL(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjI(hhhhhMubh)}(h@Writes a block of ECP data. The ``flags`` parameter is ignored.h](h!Writes a block of ECP data. The }(hjZ(hhhNhNubj)}(h ``flags``h]hflags}(hjb(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZ(ubh parameter is ignored.}(hjZ(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjI(hhubeh}(h]id131ah ]h"]h$] descriptionah&]uh1hhj(hhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hhhhhMubh)}(hThe number of bytes written.h]hThe number of bytes written.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj(hhubeh}(h]id132ah ]h"]h$] return valueah&]uh1hhj(hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hhhhhMubh)}(hecp_read_data, ecp_write_addrh]hecp_read_data, ecp_write_addr}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj(hhubeh}(h]id133ah ]h"]h$]see alsoah&]uh1hhj(hhhhhMjKubeh}(h]1port-ops-ecp-write-data-write-a-block-of-ecp-dataah ]h"]5port->ops->ecp_write_data - write a block of ecp dataah$]h&]uh1hhjIhhhhhMsubh)}(hhh](h)}(h3port->ops->ecp_read_data - read a block of ECP datah]h3port->ops->ecp_read_data - read a block of ECP data}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hhhhhMubj*)}(h#include struct parport_operations { ... size_t (*ecp_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*ecp_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };}hj(sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj(hhubeh}(h]id134ah ]h"]h$]synopsisah&]uh1hhj(hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hhhhhMubh)}(h?Reads a block of ECP data. The ``flags`` parameter is ignored.h](h Reads a block of ECP data. The }(hj!)hhhNhNubj)}(h ``flags``h]hflags}(hj))hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!)ubh parameter is ignored.}(hj!)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj)hhubeh}(h]id135ah ]h"]h$] descriptionah&]uh1hhj(hhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hjL)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjI)hhhhhMubh)}(h}The number of bytes read. NB. There may be more unread data in a FIFO. Is there a way of stunning the FIFO to prevent this?h]h}The number of bytes read. NB. There may be more unread data in a FIFO. Is there a way of stunning the FIFO to prevent this?}(hjZ)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjI)hhubeh}(h]id136ah ]h"]h$] return valueah&]uh1hhj(hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hjs)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjp)hhhhhMubh)}(hecp_write_block, ecp_write_addrh]hecp_write_block, ecp_write_addr}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjp)hhubeh}(h]id137ah ]h"]h$]see alsoah&]uh1hhj(hhhhhMjKubeh}(h]/port-ops-ecp-read-data-read-a-block-of-ecp-dataah ]h"]3port->ops->ecp_read_data - read a block of ecp dataah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h:port->ops->ecp_write_addr - write a block of ECP addressesh]h:port->ops->ecp_write_addr - write a block of ECP addresses}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hhhhhMubj*)}(h#include struct parport_operations { ... size_t (*ecp_write_addr) (struct parport *port, const void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*ecp_write_addr) (struct parport *port, const void *buf, size_t len, int flags); ... };}hj)sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj)hhubeh}(h]id138ah ]h"]h$]synopsisah&]uh1hhj)hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hhhhhMubh)}(hEWrites a block of ECP addresses. The ``flags`` parameter is ignored.h](h&Writes a block of ECP addresses. The }(hj)hhhNhNubj)}(h ``flags``h]hflags}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubh parameter is ignored.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj)hhubeh}(h]id139ah ]h"]h$] descriptionah&]uh1hhj)hhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhMubh)}(hThe number of bytes written.h]hThe number of bytes written.}(hj!*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*hhubeh}(h]id140ah ]h"]h$] return valueah&]uh1hhj)hhhhhMjKubh)}(hhh](h)}(hNOTESh]hNOTES}(hj:*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7*hhhhhMubh)}(hHThis may use a FIFO, and if so shall not return until the FIFO is empty.h]hHThis may use a FIFO, and if so shall not return until the FIFO is empty.}(hjH*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj7*hhubeh}(h]id141ah ]h"]h$]notesah&]uh1hhj)hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hja*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^*hhhhhMubh)}(hecp_read_data, ecp_write_datah]hecp_read_data, ecp_write_data}(hjo*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj^*hhubeh}(h]id142ah ]h"]h$]see alsoah&]uh1hhj)hhhhhMjKubeh}(h]6port-ops-ecp-write-addr-write-a-block-of-ecp-addressesah ]h"]:port->ops->ecp_write_addr - write a block of ecp addressesah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(hAport->ops->nibble_read_data - read a block of data in nibble modeh]hAport->ops->nibble_read_data - read a block of data in nibble mode}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhMubj*)}(h#include struct parport_operations { ... size_t (*nibble_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*nibble_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };}hj*sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhMhj*hhubeh}(h]id143ah ]h"]h$]synopsisah&]uh1hhj*hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhMubh)}(hJReads a block of data in nibble mode. The ``flags`` parameter is ignored.h](h+Reads a block of data in nibble mode. The }(hj*hhhNhNubj)}(h ``flags``h]hflags}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubh parameter is ignored.}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj*hhubeh}(h]id144ah ]h"]h$] descriptionah&]uh1hhj*hhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhMubh)}(hThe number of whole bytes read.h]hThe number of whole bytes read.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*hhubeh}(h]id145ah ]h"]h$] return valueah&]uh1hhj*hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj(+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%+hhhhhMubh)}(h!byte_read_data, compat_write_datah]h!byte_read_data, compat_write_data}(hj6+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj%+hhubeh}(h]id146ah ]h"]h$]see alsoah&]uh1hhj*hhhhhMjKubeh}(h]=port-ops-nibble-read-data-read-a-block-of-data-in-nibble-modeah ]h"]Aport->ops->nibble_read_data - read a block of data in nibble modeah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(h=port->ops->byte_read_data - read a block of data in byte modeh]h=port->ops->byte_read_data - read a block of data in byte mode}(hjW+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjT+hhhhhMubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hjh+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhje+hhhhhMubj*)}(h#include struct parport_operations { ... size_t (*byte_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*byte_read_data) (struct parport *port, void *buf, size_t len, int flags); ... };}hjv+sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM hje+hhubeh}(h]id147ah ]h"]h$]synopsisah&]uh1hhjT+hhhhhMjKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hhhhhMubh)}(hHReads a block of data in byte mode. The ``flags`` parameter is ignored.h](h)Reads a block of data in byte mode. The }(hj+hhhNhNubj)}(h ``flags``h]hflags}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh parameter is ignored.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj+hhubeh}(h]id148ah ]h"]h$] descriptionah&]uh1hhjT+hhhhhMjKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hhhhhMubh)}(hThe number of bytes read.h]hThe number of bytes read.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj+hhubeh}(h]id149ah ]h"]h$] return valueah&]uh1hhjT+hhhhhMjKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hhhhhMubh)}(h#nibble_read_data, compat_write_datah]h#nibble_read_data, compat_write_data}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj+hhubeh}(h]id150ah ]h"]h$]see alsoah&]uh1hhjT+hhhhhMjKubeh}(h]9port-ops-byte-read-data-read-a-block-of-data-in-byte-modeah ]h"]=port->ops->byte_read_data - read a block of data in byte modeah$]h&]uh1hhjIhhhhhMubh)}(hhh](h)}(hJport->ops->compat_write_data - write a block of data in compatibility modeh]hJport->ops->compat_write_data - write a block of data in compatibility mode}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hhhhhM&ubh)}(hhh](h)}(hSYNOPSISh]hSYNOPSIS}(hj/,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,,hhhhhM)ubj*)}(h#include struct parport_operations { ... size_t (*compat_write_data) (struct parport *port, const void *buf, size_t len, int flags); ... };h]h#include struct parport_operations { ... size_t (*compat_write_data) (struct parport *port, const void *buf, size_t len, int flags); ... };}hj=,sbah}(h]h ]h"]h$]h&]j9j:uh1j)hhhM-hj,,hhubeh}(h]id151ah ]h"]h$]synopsisah&]uh1hhj,hhhhhM)jKubh)}(hhh](h)}(h DESCRIPTIONh]h DESCRIPTION}(hjV,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjS,hhhhhM7ubh)}(hRWrites a block of data in compatibility mode. The ``flags`` parameter is ignored.h](h3Writes a block of data in compatibility mode. The }(hjd,hhhNhNubj)}(h ``flags``h]hflags}(hjl,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd,ubh parameter is ignored.}(hjd,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM9hjS,hhubeh}(h]id152ah ]h"]h$] descriptionah&]uh1hhj,hhhhhM7jKubh)}(hhh](h)}(h RETURN VALUEh]h RETURN VALUE}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hhhhhM=ubh)}(hThe number of bytes written.h]hThe number of bytes written.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM?hj,hhubeh}(h]id153ah ]h"]h$] return valueah&]uh1hhj,hhhhhM=jKubh)}(hhh](h)}(hSEE ALSOh]hSEE ALSO}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hhhhhMBubh)}(h nibble_read_data, byte_read_datah]h nibble_read_data, byte_read_data}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhj,hhubeh}(h]id154ah ]h"]h$]see alsoah&]uh1hhj,hhhhhMBjKubeh}(h]Fport-ops-compat-write-data-write-a-block-of-data-in-compatibility-modeah ]h"]Jport->ops->compat_write_data - write a block of data in compatibility modeah$]h&]uh1hhjIhhhhhM&ubeh}(h]port-functionsah ]h"]port functionsah$]h&]uh1hhhhhhhhMubeh}(h]parport-interface-documentationah ]h"]parport interface documentationah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj-error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j,j,jFjCjjsynopsisN descriptionN return valueNerrorsNexampleNsee alsoNjjjjnotesNj< j9 j j j j jfjcjjj{jxjjjIjFjjjxjuj-j*jjjpjmjujrj`j]jJjGj4j1j>j;j,j,jjjj~jjj. j+ j j jf!jc!j!j!j"j"j#j #j#j#j$j$j%j%j&j&j(j (j(j(j)j)j*j*jQ+jN+j,j,j,j,u nametypes}(j,jFjjX-jY-jZ-j[-j\-j]-jjj^-j< j j jfjj{jjIjjxj-jjpjuj`jJj4j>j,jjjj. j jf!j!j"j#j#j$j%j&j(j(j)j*jQ+j,j,uh}(j,hjCjqjjjjj:jjaj@jjgjjjjjjjjj<jjbjAjjgjjjjj$jj]j*jjbjjjjjjj9 jj7jj j=j j j j j j j1 j j j? j jl j j j j j j j; j j jA j j jm j j js jcj j j j j j4jj[j:jjijjzjjjMjjjSjjjxjj4jj[j:jIjajpjOjj~jjjjjjjjjFjj*j jQj0j>jWjjLj~j]jjjjjjjujjjjjjFj%jmjLj*j{jjjjjjj"jjj0jbjAjjhjjjjjmjjjj>jjejDjrjsjjjjjjjDj#jjjIj]jxjjjjj.jjUj4jGjcjjtjjjjjjj?jj1jMjj^jjjjjjj)jj;j7jijHjjojjj jj3jj,jIjjhjjyjjjjj~jj(jjOj.jvjUjjjjjnjjjtj+ jjjjjj# j j j1 jc jB j ji j j jc!j j j j4!j!j[!j:!j!ji!j!jz!j!j!j!j!j"j!j)"j"jP"j/"jw"jV"j #j"j"j"j"j"j#j"j#j#jE#j$#jl#jK#j#jr#j$j#j#j#j$j#j$j$j%j$j$j$j%j$j%j%j&j%j%j%j&j&j&j&j (j&j 'j&j'j&'j(j'j(j(jC(j"(j|(jI(j(j(j(j(j)j(j )j(jC)j)jj)jI)j)jp)j*j)j)j)j *j)j1*j*jX*j7*j*j^*jN+j*j*j*j*j*j+j*jF+j%+j,jT+j+je+j+j+j+j+j ,j+j,j,jM,j,,j,jS,j,j,j,j,u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j"-KsRparse_messages](hsystem_message)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-ubah}(h]h ]h"]h$]h&]jalevelKtypeINFOsourcehʌlineKuh1j}-hjhhhhhKubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-ubah}(h]h ]h"]h$]h&]j<alevelKtypej-sourcehʌlineM uh1j}-hjhhhhhM ubj~-)}(hhh]h)}(h*Duplicate implicit target name: "example".h]h.Duplicate implicit target name: “example”.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-ubah}(h]h ]h"]h$]h&]jbalevelKtypej-sourcehʌlineMuh1j}-hjAhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM#uh1j}-hjghhhhhM#ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM-uh1j}-hjhhhhhM-ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj .hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.ubah}(h]h ]h"]h$]h&]j$alevelKtypej-sourcehʌlineM6uh1j}-hjhhhhhM6ubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj%.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj".ubah}(h]h ]h"]h$]h&]j]alevelKtypej-sourcehʌlineM?uh1j}-hj*hhhhhM?ubj~-)}(hhh]h)}(h)Duplicate implicit target name: "errors".h]h-Duplicate implicit target name: “errors”.}(hj@.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=.ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMEuh1j}-hjbhhhhhMEubj~-)}(hhh]h)}(h*Duplicate implicit target name: "example".h]h.Duplicate implicit target name: “example”.}(hj[.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjX.ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMKuh1j}-hjhhhhhMKubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hjv.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjs.ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMeuh1j}-hjhhhhhMeubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.ubah}(h]h ]h"]h$]h&]j7alevelKtypej-sourcehʌlineMouh1j}-hjhhhhhMoubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMuh1j}-hj=hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h)Duplicate implicit target name: "errors".h]h-Duplicate implicit target name: “errors”.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h*Duplicate implicit target name: "example".h]h.Duplicate implicit target name: “example”.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/ubah}(h]h ]h"]h$]h&]j1 alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj3/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0/ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMuh1j}-hjl hhhhhMubj~-)}(hhh]h)}(h*Duplicate implicit target name: "example".h]h.Duplicate implicit target name: “example”.}(hjN/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjK/ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hji/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjf/ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/ubah}(h]h ]h"]h$]h&]j; alevelKtypej-sourcehʌlineM$uh1j}-hj hhhhhM$ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineM.uh1j}-hjA hhhhhM.ubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineM8uh1j}-hj hhhhhM8ubj~-)}(hhh]h)}(h)Duplicate implicit target name: "errors".h]h-Duplicate implicit target name: “errors”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/ubah}(h]h ]h"]h$]h&]jm alevelKtypej-sourcehʌlineMAuh1j}-hj hhhhhMAubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMIuh1j}-hjs hhhhhMIubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj 0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMSuh1j}-hj hhhhhMSubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj&0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#0ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineM\uh1j}-hj hhhhhM\ubj~-)}(hhh]h)}(h*Duplicate implicit target name: "example".h]h.Duplicate implicit target name: “example”.}(hjA0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>0ubah}(h]h ]h"]h$]h&]j4alevelKtypej-sourcehʌlineMcuh1j}-hjhhhhhMcubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj\0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjY0ubah}(h]h ]h"]h$]h&]j[alevelKtypej-sourcehʌlineMsuh1j}-hj:hhhhhMsubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hjw0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjt0ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM}uh1j}-hjzhhhhhM}ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0ubah}(h]h ]h"]h$]h&]jMalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h)Duplicate implicit target name: "errors".h]h-Duplicate implicit target name: “errors”.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjShhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0ubah}(h]h ]h"]h$]h&]j4alevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&]j[alevelKtypej-sourcehʌlineMuh1j}-hj:hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj41hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj11ubah}(h]h ]h"]h$]h&]jIalevelKtypej-sourcehʌlineMuh1j}-hjahhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hjO1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjL1ubah}(h]h ]h"]h$]h&]jpalevelKtypej-sourcehʌlineMuh1j}-hjOhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hjj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjg1ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&]j*alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&]jQalevelKtypej-sourcehʌlineMuh1j}-hj0hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj 2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj 2ubah}(h]h ]h"]h$]h&]j>alevelKtypej-sourcehʌlineMuh1j}-hjWhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj'2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$2ubah}(h]h ]h"]h$]h&]j~alevelKtypej-sourcehʌlineMuh1j}-hj]hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hjB2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?2ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj]2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZ2ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hjx2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhju2ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM'uh1j}-hjhhhhhM'ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM1uh1j}-hjhhhhhM1ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM:uh1j}-hjhhhhhM:ubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2ubah}(h]h ]h"]h$]h&]jFalevelKtypej-sourcehʌlineM@uh1j}-hj%hhhhhM@ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2ubah}(h]h ]h"]h$]h&]jmalevelKtypej-sourcehʌlineMEuh1j}-hjLhhhhhMEubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMOuh1j}-hjhhhhhMOubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMXuh1j}-hjhhhhhMXubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj53hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj23ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM^uh1j}-hjhhhhhM^ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hjP3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjM3ubah}(h]h ]h"]h$]h&]j"alevelKtypej-sourcehʌlineMcuh1j}-hjhhhhhMcubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hjk3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh3ubah}(h]h ]h"]h$]h&]jbalevelKtypej-sourcehʌlineMnuh1j}-hjAhhhhhMnubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM|uh1j}-hjhhhhhhM|ubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3ubah}(h]h ]h"]h$]h&]j>alevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj 4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj 4ubah}(h]h ]h"]h$]h&]jealevelKtypej-sourcehʌlineMuh1j}-hjDhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj(4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%4ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hjC4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@4ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj^4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[4ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h(Duplicate implicit target name: "notes".h]h,Duplicate implicit target name: “notes”.}(hjy4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjv4ubah}(h]h ]h"]h$]h&]jDalevelKtypej-sourcehʌlineMuh1j}-hj#hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4ubah}(h]h ]h"]h$]h&]jjalevelKtypej-sourcehʌlineMuh1j}-hjIhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4ubah}(h]h ]h"]h$]h&]j.alevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4ubah}(h]h ]h"]h$]h&]jUalevelKtypej-sourcehʌlineMuh1j}-hj4hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjthhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj65hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj35ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hjQ5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjN5ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h(Duplicate implicit target name: "notes".h]h,Duplicate implicit target name: “notes”.}(hjl5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhji5ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5ubah}(h]h ]h"]h$]h&]j?alevelKtypej-sourcehʌlineM&uh1j}-hjhhhhhM&ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM0uh1j}-hj^hhhhhM0ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM9uh1j}-hjhhhhhM9ubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineM?uh1j}-hjhhhhhM?ubj~-)}(hhh]h)}(h(Duplicate implicit target name: "notes".h]h,Duplicate implicit target name: “notes”.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMEuh1j}-hjhhhhhMEubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj 6ubah}(h]h ]h"]h$]h&]j)alevelKtypej-sourcehʌlineMPuh1j}-hjhhhhhMPubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj)6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&6ubah}(h]h ]h"]h$]h&]jialevelKtypej-sourcehʌlineM[uh1j}-hjHhhhhhM[ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hjD6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjA6ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMduh1j}-hjohhhhhMdubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj_6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\6ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMjuh1j}-hjhhhhhMjubj~-)}(hhh]h)}(h(Duplicate implicit target name: "notes".h]h,Duplicate implicit target name: “notes”.}(hjz6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjw6ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineMouh1j}-hjhhhhhMoubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6ubah}(h]h ]h"]h$]h&]j3alevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjyhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6ubah}(h]h ]h"]h$]h&]j(alevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7ubah}(h]h ]h"]h$]h&]jOalevelKtypej-sourcehʌlineMuh1j}-hj.hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj77hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj47ubah}(h]h ]h"]h$]h&]jvalevelKtypej-sourcehʌlineMuh1j}-hjUhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hjR7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjO7ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hjm7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjj7ubah}(h]h ]h"]h$]h&]jnalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjthhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7ubah}(h]h ]h"]h$]h&]jalevelKtypej-sourcehʌlineMuh1j}-hjhhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7ubah}(h]h ]h"]h$]h&]j# alevelKtypej-sourcehʌlineMuh1j}-hj hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7ubah}(h]h ]h"]h$]h&]jc alevelKtypej-sourcehʌlineMuh1j}-hjB hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj 8ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineM uh1j}-hji hhhhhM ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj*8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'8ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineM.uh1j}-hj hhhhhM.ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hjE8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjB8ubah}(h]h ]h"]h$]h&]j alevelKtypej-sourcehʌlineM9uh1j}-hj hhhhhM9ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj`8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]8ubah}(h]h ]h"]h$]h&]j4!alevelKtypej-sourcehʌlineMHuh1j}-hj!hhhhhMHubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj{8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjx8ubah}(h]h ]h"]h$]h&]j[!alevelKtypej-sourcehʌlineMSuh1j}-hj:!hhhhhMSubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8ubah}(h]h ]h"]h$]h&]j!alevelKtypej-sourcehʌlineM^uh1j}-hjz!hhhhhM^ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8ubah}(h]h ]h"]h$]h&]j!alevelKtypej-sourcehʌlineMkuh1j}-hj!hhhhhMkubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8ubah}(h]h ]h"]h$]h&]j!alevelKtypej-sourcehʌlineMsuh1j}-hj!hhhhhMsubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8ubah}(h]h ]h"]h$]h&]j)"alevelKtypej-sourcehʌlineM~uh1j}-hj"hhhhhM~ubj~-)}(h5hh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8ubah}(h]h ]h"]h$]h&]jP"alevelKtypej-sourcehʌlineMuh1j}-hj/"hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9ubah}(h]h ]h"]h$]h&]jw"alevelKtypej-sourcehʌlineMuh1j}-hjV"hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj89hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj59ubah}(h]h ]h"]h$]h&]j"alevelKtypej-sourcehʌlineMuh1j}-hj"hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hjS9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjP9ubah}(h]h ]h"]h$]h&]j"alevelKtypej-sourcehʌlineMuh1j}-hj"hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hjn9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjk9ubah}(h]h ]h"]h$]h&]j#alevelKtypej-sourcehʌlineMuh1j}-hj"hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9ubah}(h]h ]h"]h$]h&]jE#alevelKtypej-sourcehʌlineMuh1j}-hj$#hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9ubah}(h]h ]h"]h$]h&]jl#alevelKtypej-sourcehʌlineMuh1j}-hjK#hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9ubah}(h]h ]h"]h$]h&]j#alevelKtypej-sourcehʌlineMuh1j}-hjr#hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9ubah}(h]h ]h"]h$]h&]j#alevelKtypej-sourcehʌlineMuh1j}-hj#hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9ubah}(h]h ]h"]h$]h&]j$alevelKtypej-sourcehʌlineMuh1j}-hj#hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj :ubah}(h]h ]h"]h$]h&]j$alevelKtypej-sourcehʌlineMuh1j}-hj$hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj+:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(:ubah}(h]h ]h"]h$]h&]j$alevelKtypej-sourcehʌlineMuh1j}-hj$hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hjF:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjC:ubah}(h]h ]h"]h$]h&]j%alevelKtypej-sourcehʌlineM uh1j}-hj$hhhhhM ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hja:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^:ubah}(h]h ]h"]h$]h&]j%alevelKtypej-sourcehʌlineMuh1j}-hj%hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj|:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjy:ubah}(h]h ]h"]h$]h&]j%alevelKtypej-sourcehʌlineM$uh1j}-hj%hhhhhM$ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:ubah}(h]h ]h"]h$]h&]j&alevelKtypej-sourcehʌlineM2uh1j}-hj&hhhhhM2ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:ubah}(h]h ]h"]h$]h&]j&alevelKtypej-sourcehʌlineMBuh1j}-hj&hhhhhMBubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:ubah}(h]h ]h"]h$]h&]j 'alevelKtypej-sourcehʌlineMMuh1j}-hj&hhhhhMMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:ubah}(h]h ]h"]h$]h&]j'alevelKtypej-sourcehʌlineM[uh1j}-hj&'hhhhhM[ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&]j(alevelKtypej-sourcehʌlineMkuh1j}-hj'hhhhhMkubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&]jC(alevelKtypej-sourcehʌlineMvuh1j}-hj"(hhhhhMvubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj9;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6;ubah}(h]h ]h"]h$]h&]j|(alevelKtypej-sourcehʌlineMuh1j}-hjI(hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hjT;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQ;ubah}(h]h ]h"]h$]h&]j(alevelKtypej-sourcehʌlineMuh1j}-hj(hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hjo;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjl;ubah}(h]h ]h"]h$]h&]j(alevelKtypej-sourcehʌlineMuh1j}-hj(hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&]j )alevelKtypej-sourcehʌlineMuh1j}-hj(hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&]jC)alevelKtypej-sourcehʌlineMuh1j}-hj)hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&]jj)alevelKtypej-sourcehʌlineMuh1j}-hjI)hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&]j)alevelKtypej-sourcehʌlineMuh1j}-hjp)hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&]j)alevelKtypej-sourcehʌlineMuh1j}-hj)hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<ubah}(h]h ]h"]h$]h&]j *alevelKtypej-sourcehʌlineMuh1j}-hj)hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj,<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)<ubah}(h]h ]h"]h$]h&]j1*alevelKtypej-sourcehʌlineMuh1j}-hj*hhhhhMubj~-)}(hhh]h)}(h(Duplicate implicit target name: "notes".h]h,Duplicate implicit target name: “notes”.}(hjG<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjD<ubah}(h]h ]h"]h$]h&]jX*alevelKtypej-sourcehʌlineMuh1j}-hj7*hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hjb<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_<ubah}(h]h ]h"]h$]h&]j*alevelKtypej-sourcehʌlineMuh1j}-hj^*hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj}<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjz<ubah}(h]h ]h"]h$]h&]j*alevelKtypej-sourcehʌlineMuh1j}-hj*hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<ubah}(h]h ]h"]h$]h&]j*alevelKtypej-sourcehʌlineMuh1j}-hj*hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<ubah}(h]h ]h"]h$]h&]j+alevelKtypej-sourcehʌlineMuh1j}-hj*hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<ubah}(h]h ]h"]h$]h&]jF+alevelKtypej-sourcehʌlineMuh1j}-hj%+hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<ubah}(h]h ]h"]h$]h&]j+alevelKtypej-sourcehʌlineMuh1j}-hje+hhhhhMubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=ubah}(h]h ]h"]h$]h&]j+alevelKtypej-sourcehʌlineMuh1j}-hj+hhhhhMubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=ubah}(h]h ]h"]h$]h&]j+alevelKtypej-sourcehʌlineMuh1j}-hj+hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj:=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7=ubah}(h]h ]h"]h$]h&]j ,alevelKtypej-sourcehʌlineMuh1j}-hj+hhhhhMubj~-)}(hhh]h)}(h+Duplicate implicit target name: "synopsis".h]h/Duplicate implicit target name: “synopsis”.}(hjU=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjR=ubah}(h]h ]h"]h$]h&]jM,alevelKtypej-sourcehʌlineM)uh1j}-hj,,hhhhhM)ubj~-)}(hhh]h)}(h.Duplicate implicit target name: "description".h]h2Duplicate implicit target name: “description”.}(hjp=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjm=ubah}(h]h ]h"]h$]h&]j,alevelKtypej-sourcehʌlineM7uh1j}-hjS,hhhhhM7ubj~-)}(hhh]h)}(h/Duplicate implicit target name: "return value".h]h3Duplicate implicit target name: “return value”.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=ubah}(h]h ]h"]h$]h&]j,alevelKtypej-sourcehʌlineM=uh1j}-hj,hhhhhM=ubj~-)}(hhh]h)}(h+Duplicate implicit target name: "see also".h]h/Duplicate implicit target name: “see also”.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=ubah}(h]h ]h"]h$]h&]j,alevelKtypej-sourcehʌlineMBuh1j}-hj,hhhhhMBubetransform_messages] transformerN include_log] decorationNhhub.