1 .. SPDX-License-Identifier: GFDL-1.1-no-invari !! 1 .. Permission is granted to copy, distribute and/or modify this
2 .. c:namespace:: DTV.net !! 2 .. document under the terms of the GNU Free Documentation License,
>> 3 .. Version 1.1 or any later version published by the Free Software
>> 4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
>> 5 .. and no Back-Cover Texts. A copy of the license is included at
>> 6 .. Documentation/userspace-api/media/fdl-appendix.rst.
>> 7 ..
>> 8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
3 9
4 .. _NET_ADD_IF: 10 .. _NET_ADD_IF:
5 11
6 **************** 12 ****************
7 ioctl NET_ADD_IF 13 ioctl NET_ADD_IF
8 **************** 14 ****************
9 15
10 Name 16 Name
11 ==== 17 ====
12 18
13 NET_ADD_IF - Creates a new network interface f 19 NET_ADD_IF - Creates a new network interface for a given Packet ID.
14 20
>> 21
15 Synopsis 22 Synopsis
16 ======== 23 ========
17 24
18 .. c:macro:: NET_ADD_IF !! 25 .. c:function:: int ioctl( int fd, NET_ADD_IF, struct dvb_net_if *net_if )
>> 26 :name: NET_ADD_IF
19 27
20 ``int ioctl(int fd, NET_ADD_IF, struct dvb_net <<
21 28
22 Arguments 29 Arguments
23 ========= 30 =========
24 31
25 ``fd`` 32 ``fd``
26 File descriptor returned by :c:func:`open( !! 33 File descriptor returned by :ref:`open() <frontend_f_open>`.
27 34
28 ``net_if`` 35 ``net_if``
29 pointer to struct :c:type:`dvb_net_if` 36 pointer to struct :c:type:`dvb_net_if`
>> 37
30 38
31 Description 39 Description
32 =========== 40 ===========
33 41
34 The NET_ADD_IF ioctl system call selects the P 42 The NET_ADD_IF ioctl system call selects the Packet ID (PID) that
35 contains a TCP/IP traffic, the type of encapsu 43 contains a TCP/IP traffic, the type of encapsulation to be used (MPE or
36 ULE) and the interface number for the new inte 44 ULE) and the interface number for the new interface to be created. When
37 the system call successfully returns, a new vi 45 the system call successfully returns, a new virtual network interface is
38 created. 46 created.
39 47
40 The struct :c:type:`dvb_net_if`::ifnum field w 48 The struct :c:type:`dvb_net_if`::ifnum field will be
41 filled with the number of the created interfac 49 filled with the number of the created interface.
42 50
43 Return Value 51 Return Value
44 ============ 52 ============
45 53
46 On success 0 is returned, and :c:type:`ca_slot 54 On success 0 is returned, and :c:type:`ca_slot_info` is filled.
47 55
48 On error -1 is returned, and the ``errno`` var 56 On error -1 is returned, and the ``errno`` variable is set
49 appropriately. 57 appropriately.
50 58
51 The generic error codes are described at the 59 The generic error codes are described at the
52 :ref:`Generic Error Codes <gen-errors>` chapte 60 :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.