| .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later |
| .. c:namespace:: MC |
| |
| .. _media-func-open: |
| |
| ************ |
| media open() |
| ************ |
| |
| Name |
| ==== |
| |
| media-open - Open a media device |
| |
| Synopsis |
| ======== |
| |
| .. code-block:: c |
| |
| #include <fcntl.h> |
| |
| .. c:function:: int open( const char *device_name, int flags ) |
| |
| Arguments |
| ========= |
| |
| ``device_name`` |
| Device to be opened. |
| |
| ``flags`` |
| Open flags. Access mode must be either ``O_RDONLY`` or ``O_RDWR``. |
| Other flags have no effect. |
| |
| Description |
| =========== |
| |
| To open a media device applications call :c:func:`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. |
| |
| Return Value |
| ============ |
| |
| :c:func:`open()` returns the new file descriptor on success. On error, |
| -1 is returned, and ``errno`` is set appropriately. Possible error codes |
| are: |
| |
| 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. |
