1 .. SPDX-License-Identifier: GFDL-1.1-no-invari 1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: DTV.net 2 .. c:namespace:: DTV.net
3 3
4 .. _NET_GET_IF: 4 .. _NET_GET_IF:
5 5
6 **************** 6 ****************
7 ioctl NET_GET_IF 7 ioctl NET_GET_IF
8 **************** 8 ****************
9 9
10 Name 10 Name
11 ==== 11 ====
12 12
13 NET_GET_IF - Read the configuration data of an 13 NET_GET_IF - Read the configuration data of an interface created via - :ref:`NET_ADD_IF <net>`.
14 14
15 Synopsis 15 Synopsis
16 ======== 16 ========
17 17
18 .. c:macro:: NET_GET_IF 18 .. c:macro:: NET_GET_IF
19 19
20 ``int ioctl(int fd, NET_GET_IF, struct dvb_net 20 ``int ioctl(int fd, NET_GET_IF, struct dvb_net_if *net_if)``
21 21
22 Arguments 22 Arguments
23 ========= 23 =========
24 24
25 ``fd`` 25 ``fd``
26 File descriptor returned by :c:func:`open( 26 File descriptor returned by :c:func:`open()`.
27 27
28 ``net_if`` 28 ``net_if``
29 pointer to struct :c:type:`dvb_net_if` 29 pointer to struct :c:type:`dvb_net_if`
30 30
31 Description 31 Description
32 =========== 32 ===========
33 33
34 The NET_GET_IF ioctl uses the interface number 34 The NET_GET_IF ioctl uses the interface number given by the struct
35 :c:type:`dvb_net_if`::ifnum field and fills th 35 :c:type:`dvb_net_if`::ifnum field and fills the content of
36 struct :c:type:`dvb_net_if` with the packet ID 36 struct :c:type:`dvb_net_if` with the packet ID and
37 encapsulation type used on such interface. If 37 encapsulation type used on such interface. If the interface was not
38 created yet with :ref:`NET_ADD_IF <net>`, it w 38 created yet with :ref:`NET_ADD_IF <net>`, it will return -1 and fill
39 the ``errno`` with ``EINVAL`` error code. 39 the ``errno`` with ``EINVAL`` error code.
40 40
41 Return Value 41 Return Value
42 ============ 42 ============
43 43
44 On success 0 is returned, and :c:type:`ca_slot 44 On success 0 is returned, and :c:type:`ca_slot_info` is filled.
45 45
46 On error -1 is returned, and the ``errno`` var 46 On error -1 is returned, and the ``errno`` variable is set
47 appropriately. 47 appropriately.
48 48
49 The generic error codes are described at the 49 The generic error codes are described at the
50 :ref:`Generic Error Codes <gen-errors>` chapte 50 :ref:`Generic Error Codes <gen-errors>` chapter.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.