1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _NET_ADD_IF:
4
5****************
6ioctl NET_ADD_IF
7****************
8
9Name
10====
11
12NET_ADD_IF - Creates a new network interface for a given Packet ID.
13
14
15Synopsis
16========
17
18.. c:function:: int ioctl( int fd, NET_ADD_IF, struct dvb_net_if *net_if )
19    :name: NET_ADD_IF
20
21
22Arguments
23=========
24
25``fd``
26    File descriptor returned by :ref:`open() <frontend_f_open>`.
27
28``net_if``
29    pointer to struct :c:type:`dvb_net_if`
30
31
32Description
33===========
34
35The NET_ADD_IF ioctl system call selects the Packet ID (PID) that
36contains a TCP/IP traffic, the type of encapsulation to be used (MPE or
37ULE) and the interface number for the new interface to be created. When
38the system call successfully returns, a new virtual network interface is
39created.
40
41The struct :c:type:`dvb_net_if`::ifnum field will be
42filled with the number of the created interface.
43
44Return Value
45============
46
47On success 0 is returned, and :c:type:`ca_slot_info` is filled.
48
49On error -1 is returned, and the ``errno`` variable is set
50appropriately.
51
52The generic error codes are described at the
53:ref:`Generic Error Codes <gen-errors>` chapter.
54