1 .. -*- coding: utf-8; mode: rst -*-
12 cec-open - Open a cec device
22 .. cpp:function:: int open( const char *device_name, int flags )
32 Open flags. Access mode must be ``O_RDWR``.
34 When the ``O_NONBLOCK`` flag is given, the
35 :ref:`CEC_RECEIVE <CEC_RECEIVE>` and :ref:`CEC_DQEVENT <CEC_DQEVENT>` ioctls
36 will return the ``EAGAIN`` error code when no message or event is available, and
37 ioctls :ref:`CEC_TRANSMIT <CEC_TRANSMIT>`,
38 :ref:`CEC_ADAP_S_PHYS_ADDR <CEC_ADAP_S_PHYS_ADDR>` and
39 :ref:`CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`
42 Other flags have no effect.
48 .. note:: This documents the proposed CEC API. This API is not yet finalized
49 and is currently only available as a staging kernel module.
51 To open a cec device applications call :c:func:`open()` with the
52 desired device name. The function has no side effects; the device
53 configuration remain unchanged.
55 When the device is opened in read-only mode, attempts to modify its
56 configuration will result in an error, and ``errno`` will be set to
63 :c:func:`open()` returns the new file descriptor on success. On error,
64 -1 is returned, and ``errno`` is set appropriately. Possible error codes
68 The requested access to the file is not allowed.
71 The process already has the maximum number of files open.
74 The system limit on the total number of open files has been reached.
77 Insufficient kernel memory was available.
80 No device corresponding to this device special file exists.