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