2.1. cec open()¶
2.1.1. Name¶
cec-open - Open a cec device
2.1.3. Arguments¶
device_name
- Device to be opened.
flags
Open flags. Access mode must be
O_RDWR
.When the
O_NONBLOCK
flag is given, the CEC_RECEIVE and CEC_DQEVENT ioctls will return theEAGAIN
error code when no message or event is available, and ioctls CEC_TRANSMIT, CEC_ADAP_S_PHYS_ADDR and CEC_ADAP_S_LOG_ADDRS all return 0.Other flags have no effect.
2.1.4. Description¶
Note
This documents the proposed CEC API. This API is not yet finalized and is currently only available as a staging kernel module.
To open a cec device applications call open()
with the
desired device name. The function has no side effects; the device
configuration remain unchanged.
When the device is opened in read-only mode, attempts to modify its
configuration will result in an error, and errno
will be set to
EBADF.
2.1.5. Return Value¶
open()
returns the new file descriptor on success. On error,
-1 is returned, and errno
is set appropriately. Possible error codes
include:
EACCES
- The requested access to the file is not allowed.
EMFILE
- The process already has the maximum number of files open.
ENFILE
- The system limit on the total number of open files has been reached.
ENOMEM
- Insufficient kernel memory was available.
ENXIO
- No device corresponding to this device special file exists.