table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
if_nametoindex(3) | Library Functions Manual | if_nametoindex(3) |
ИМЯ¶
if_nametoindex, if_indextoname - соответствие имён и индексов сетевых интерфейсов
БИБЛИОТЕКА¶
Стандартная библиотека языка C (libc, -lc)
СИНТАКСИС¶
#include <net/if.h>
unsigned int if_nametoindex(const char *ifname); char *if_indextoname(unsigned int ifindex, char *ifname);
ОПИСАНИЕ¶
Функция if_nametoindex() возвращает индекс сетевого интерфейса, соответствующего имени ifname.
Функция if_indextoname() возвращает имя сетевого интерфейса, соответствующего индексу интерфейса ifindex. Имя помещается в буфер, указанный в ifname. Буфер должен позволять хранить не менее IF_NAMESIZE байт.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
On success, if_nametoindex() returns the index number of the network interface; on error, 0 is returned and errno is set to indicate the error.
On success, if_indextoname() returns ifname; on error, NULL is returned and errno is set to indicate the error.
ОШИБКИ¶
Функция if_nametoindex() может завершиться с ошибкой и изменить errno если:
- ENODEV
- Не найден интерфейс с заданным именем.
Функция if_indextoname() может завершиться с ошибкой и изменить errno если:
- ENXIO
- Интерфейс по индексу не найден.
Также функции if_nametoindex() и if_indextoname() могут завершиться с ошибками, перечисленными в socket(2) или ioctl(2).
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
if_nametoindex(), if_indextoname() | Безвредность в нитях | MT-Safe |
СТАНДАРТЫ¶
POSIX.1-2001, POSIX.1-2008, RFC 3493.
Эта функция впервые появилась в BSDi.
СМОТРИТЕ ТАКЖЕ¶
ПЕРЕВОД¶
Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.
15 декабря 2022 г. | Справочные страницы Linux 6.03 |