NETDEVICE(7) | Manual del Programador de Linux | NETDEVICE(7) |
netdevice - acceso de bajo nivel a los dispositivos de red de Linux
#include <sys/ioctl.h>
#include <net/if.h>
Esta página de manual describe la interfaz de conectores que se usa para configurar los dispositivos de red.
Linux supports some standard ioctls to configure network devices. They can be used on any socket's file descriptor regardless of the family or type. Most of them pass an ifreq structure:
struct ifreq {
char ifr_name[IFNAMSIZ]; /* Nombre de la interfaz */
union {
struct sockaddr ifr_addr;
struct sockaddr ifr_dstaddr;
struct sockaddr ifr_broadaddr;
struct sockaddr ifr_netmask;
struct sockaddr ifr_hwaddr;
short ifr_flags;
int ifr_ifindex;
int ifr_metric;
int ifr_mtu;
struct ifmap ifr_map;
char ifr_slave[IFNAMSIZ];
char ifr_newname[IFNAMSIZ];
char *ifr_data;
}; };
Normalmente, el usuario especifica a qué dispositivo va a afectar asignando a ifr_name el nombre de la interfaz. Todos los otros miembros de la estructura pueden compartir memoria.
Si se marca una ioctl como privilegiada entonces su uso requiere un identificador de usuario efectivo 0 o la capacidad CAP_NET_ADMIN. Si éste no es el caso se devuelve EPERM.
Significado de las banderas | |
IFF_UP | La interfaz está funcionando. |
IFF_BROADCAST | Dirección de difusión válida asignada. |
IFF_DEBUG | Bandera de depuración interna. |
IFF_LOOPBACK | Ésta es una interfaz loopback. |
IFF_POINTOPOINT | La interfaz es un enlace punto a punto. |
IFF_RUNNING | Recursos necesarios reservados. |
IFF_NOARP | Sin protocolo ARP, la dirección de destino de Nivel 2 no está configurada. |
IFF_PROMISC | La interfaz se encuentra en modo promiscuo. |
IFF_NOTRAILERS | Evitar el uso de terminadores. |
IFF_ALLMULTI | Recibir todos los paquetes multidestino. |
IFF_MASTER | Interfaz maestra de un grupo de balanceo de carga. |
IFF_SLAVE | Interfaz esclava de un grupo de balanceo de carga. |
IFF_MULTICAST | La interfaz soporta multidestino. |
IFF_PORTSEL | La interfaz es capaz de seleccionar el tipo de medio mediante ifmap. |
IFF_AUTOMEDIA | Autoselección de medios activa. |
IFF_DYNAMIC | Las direcciones se pierden cuando la interfaz se desactiva. |
IFF_LOWER_UP | Driver signals L1 up (since Linux 2.6.17) |
IFF_DORMANT | Driver signals dormant (since Linux 2.6.17) |
IFF_ECHO | Echo sent packets (since Linux 2.6.25) |
La configuración de la palabra de banderas activas es una operación privilegiada pero cualquier proceso puede leerla.
Private flags | |
IFF_802_1Q_VLAN | Interface is 802.1Q VLAN device. |
IFF_EBRIDGE | Interface is Ethernet bridging device. |
IFF_SLAVE_INACTIVE | Interface is inactive bonding slave. |
IFF_MASTER_8023AD | Interface is 802.3ad bonding master. |
IFF_MASTER_ALB | Interface is balanced-alb bonding master. |
IFF_BONDING | Interface is a bonding master or slave. |
IFF_SLAVE_NEEDARP | Interface needs ARPs for validation. |
IFF_ISATAP | Interface is RFC4214 ISATAP interface. |
Setting the extended (private) interface flags is a privileged operation.
struct ifmap {
unsigned long mem_start;
unsigned long mem_end;
unsigned short base_addr;
unsigned char irq;
unsigned char dma;
unsigned char port; };
struct ifconf {
int ifc_len; /* size of buffer */
union {
char *ifc_buf; /* buffer address */
struct ifreq *ifc_req; /* array of structures */
}; };
La mayoría de los protocolos soportan sus propias ioctls para configurar las opciones de la interfaz específicas del protocolo. Vea las páginas de manual de los protocolos para una descripción más amplia. Para la configuración de direcciones IP, vea ip(7).
Además, algunos dispositivos soportan ioctls privadas. Éstas no se describen aquí.
SIOCGIFCONF and the other ioctls that accept or return only AF_INET socket addresses are IP-specific and perhaps should rather be documented in ip(7).
Los nombres de interfaces que no tiene dirección o que no tienen la opción IFF_RUNNING activa, se pueden encontrar a través de /proc/net/dev.
Las direcciones IP locales versión 6 (IPv6) se pueden obtener vía /proc/net o vía rtnetlink(7).
glibc 2.1 no posee la macro ifr_newname en <net/if.h>. Añada lo siguiente a su programa como solución:
#ifndef ifr_newname #define ifr_newname ifr_ifru.ifru_slave #endif
Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.
La traducción al español de esta página del manual fue creada por Juan Piernas <piernas@ditec.um.es>
Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.
Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org>..
13 Agosto 2020 | Linux |