1 .. SPDX-License-Identifier: GFDL-1.1-no-invari 1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: MC 2 .. c:namespace:: MC
3 3
4 .. _media-func-open: 4 .. _media-func-open:
5 5
6 ************ 6 ************
7 media open() 7 media open()
8 ************ 8 ************
9 9
10 Name 10 Name
11 ==== 11 ====
12 12
13 media-open - Open a media device 13 media-open - Open a media device
14 14
15 Synopsis 15 Synopsis
16 ======== 16 ========
17 17
18 .. code-block:: c 18 .. code-block:: c
19 19
20 #include <fcntl.h> 20 #include <fcntl.h>
21 21
22 .. c:function:: int open( const char *device_n 22 .. c:function:: int open( const char *device_name, int flags )
23 23
24 Arguments 24 Arguments
25 ========= 25 =========
26 26
27 ``device_name`` 27 ``device_name``
28 Device to be opened. 28 Device to be opened.
29 29
30 ``flags`` 30 ``flags``
31 Open flags. Access mode must be either ``O 31 Open flags. Access mode must be either ``O_RDONLY`` or ``O_RDWR``.
32 Other flags have no effect. 32 Other flags have no effect.
33 33
34 Description 34 Description
35 =========== 35 ===========
36 36
37 To open a media device applications call :c:fu 37 To open a media device applications call :c:func:`open()` with the
38 desired device name. The function has no side 38 desired device name. The function has no side effects; the device
39 configuration remain unchanged. 39 configuration remain unchanged.
40 40
41 When the device is opened in read-only mode, a 41 When the device is opened in read-only mode, attempts to modify its
42 configuration will result in an error, and ``e 42 configuration will result in an error, and ``errno`` will be set to
43 EBADF. 43 EBADF.
44 44
45 Return Value 45 Return Value
46 ============ 46 ============
47 47
48 :c:func:`open()` returns the new file descript 48 :c:func:`open()` returns the new file descriptor on success. On error,
49 -1 is returned, and ``errno`` is set appropria 49 -1 is returned, and ``errno`` is set appropriately. Possible error codes
50 are: 50 are:
51 51
52 EACCES 52 EACCES
53 The requested access to the file is not al 53 The requested access to the file is not allowed.
54 54
55 EMFILE 55 EMFILE
56 The process already has the maximum number 56 The process already has the maximum number of files open.
57 57
58 ENFILE 58 ENFILE
59 The system limit on the total number of op 59 The system limit on the total number of open files has been reached.
60 60
61 ENOMEM 61 ENOMEM
62 Insufficient kernel memory was available. 62 Insufficient kernel memory was available.
63 63
64 ENXIO 64 ENXIO
65 No device corresponding to this device spe 65 No device corresponding to this device special file exists.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.