xref: /linux/Documentation/userspace-api/media/dvb/net-remove-if.rst (revision f9b2e8aa326fefa21360a778e40cae486969293b)
1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2*f9b2e8aaSMauro Carvalho Chehab.. c:namespace:: DTV.net
354f38fcaSMauro Carvalho Chehab
454f38fcaSMauro Carvalho Chehab.. _NET_REMOVE_IF:
554f38fcaSMauro Carvalho Chehab
654f38fcaSMauro Carvalho Chehab*******************
754f38fcaSMauro Carvalho Chehabioctl NET_REMOVE_IF
854f38fcaSMauro Carvalho Chehab*******************
954f38fcaSMauro Carvalho Chehab
1054f38fcaSMauro Carvalho ChehabName
1154f38fcaSMauro Carvalho Chehab====
1254f38fcaSMauro Carvalho Chehab
1354f38fcaSMauro Carvalho ChehabNET_REMOVE_IF - Removes a network interface.
1454f38fcaSMauro Carvalho Chehab
1554f38fcaSMauro Carvalho ChehabSynopsis
1654f38fcaSMauro Carvalho Chehab========
1754f38fcaSMauro Carvalho Chehab
18*f9b2e8aaSMauro Carvalho Chehab.. c:macro:: NET_REMOVE_IF
1954f38fcaSMauro Carvalho Chehab
20*f9b2e8aaSMauro Carvalho Chehab``int ioctl(int fd, NET_REMOVE_IF, int ifnum)``
2154f38fcaSMauro Carvalho Chehab
2254f38fcaSMauro Carvalho ChehabArguments
2354f38fcaSMauro Carvalho Chehab=========
2454f38fcaSMauro Carvalho Chehab
2554f38fcaSMauro Carvalho Chehab``fd``
26*f9b2e8aaSMauro Carvalho Chehab    File descriptor returned by :c:func:`open()`.
2754f38fcaSMauro Carvalho Chehab
2854f38fcaSMauro Carvalho Chehab``net_if``
2954f38fcaSMauro Carvalho Chehab    number of the interface to be removed
3054f38fcaSMauro Carvalho Chehab
3154f38fcaSMauro Carvalho ChehabDescription
3254f38fcaSMauro Carvalho Chehab===========
3354f38fcaSMauro Carvalho Chehab
3454f38fcaSMauro Carvalho ChehabThe NET_REMOVE_IF ioctl deletes an interface previously created via
3554f38fcaSMauro Carvalho Chehab:ref:`NET_ADD_IF <net>`.
3654f38fcaSMauro Carvalho Chehab
3754f38fcaSMauro Carvalho ChehabReturn Value
3854f38fcaSMauro Carvalho Chehab============
3954f38fcaSMauro Carvalho Chehab
4054f38fcaSMauro Carvalho ChehabOn success 0 is returned, and :c:type:`ca_slot_info` is filled.
4154f38fcaSMauro Carvalho Chehab
4254f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set
4354f38fcaSMauro Carvalho Chehabappropriately.
4454f38fcaSMauro Carvalho Chehab
4554f38fcaSMauro Carvalho ChehabThe generic error codes are described at the
4654f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter.
47