1 .. SPDX-License-Identifier: GFDL-1.1-no-invari
2 .. c:namespace:: CEC
3
4 .. _cec-func-open:
5
6 **********
7 cec open()
8 **********
9
10 Name
11 ====
12
13 cec-open - Open a cec device
14
15 Synopsis
16 ========
17
18 .. code-block:: c
19
20 #include <fcntl.h>
21
22 .. c:function:: int open( const char *device_n
23
24 Arguments
25 =========
26
27 ``device_name``
28 Device to be opened.
29
30 ``flags``
31 Open flags. Access mode must be ``O_RDWR``
32
33 When the ``O_NONBLOCK`` flag is given, the
34 :ref:`CEC_RECEIVE <CEC_RECEIVE>` and :ref:
35 will return the ``EAGAIN`` error code when
36 ioctls :ref:`CEC_TRANSMIT <CEC_TRANSMIT>`,
37 :ref:`CEC_ADAP_S_PHYS_ADDR <CEC_ADAP_S_PHY
38 :ref:`CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG
39 all return 0.
40
41 Other flags have no effect.
42
43 Description
44 ===========
45
46 To open a cec device applications call :c:func
47 desired device name. The function has no side
48 configuration remain unchanged.
49
50 When the device is opened in read-only mode, a
51 configuration will result in an error, and ``e
52 EBADF.
53
54 Return Value
55 ============
56
57 :c:func:`open()` returns the new file descript
58 -1 is returned, and ``errno`` is set appropria
59 include:
60
61 ``EACCES``
62 The requested access to the file is not al
63
64 ``EMFILE``
65 The process already has the maximum number
66
67 ``ENFILE``
68 The system limit on the total number of op
69
70 ``ENOMEM``
71 Insufficient kernel memory was available.
72
73 ``ENODEV``
74 Device not found or was removed.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.