| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465 |
- .. 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.
|
