SKŁADNIA

ifconfig [-v] [-a] [-s] [interfejs]
ifconfig [-v] interfejs [typ-rodz-adr] opcje | adres ...

OPIS

Ifconfig jest używany do konfigurowania rezydujących w jądrze interfejsów sieciowych. Jest używany podczas rozruchu, do skonfigurowania większości z nich do stanu pracy. Później jest zwykle potrzebny tylko przy debugowaniu lub tuningowaniu systemu.

Jeśli nie poda się argumentów, ifconfig po prostu wyświetli status aktywnych interfejsów. Jeśli podany jest pojedynczy argument interfejs, to wyświetla on status podanego interfejsu. Jeżeli użyto pojedynczego argumentu -a, to wyświetlony zostanie status wszystkich interfejsów, nawet tych, które są nieaktywne. W przeciwnym wypadku zakłada, że trzeba coś skonfigurować.

Rodziny adresów

Jeśli pierwszy argument po nazwie interfejsu jest rozpoznany jako nazwa obsługiwanej rodziny adresów, to ta rodzina adresów jest używana do dekodowania i wyświetlania wszystkich adresów protokołowych. Obecnie, obsługiwane są następujące rodziny adresów: inet (TCP/IP, domyślne), inet6 (IPv6), ax25 (AMPR Packet Radio), ddp (Appletalk Phase 2), ipx (Novell IPX) i netrom (AMPR Packet radio).

OPCJE

-a

wyświetla wszystkie aktualnie dostępne interfejsy, nawet jeśli nie są aktywne

-s

wyświetla krótką listę (jak netstat -i)

-v

więcej szczegółów w przypadku niektórych błędów

interfejs

Nazwa interfejsu sieciowego. Jest to zwykle nazwa sterownika, za którą następuje numer jednostki, na przykład eth0 oznacza pierwszy interfejs ethernetowy. Jeśli jądro obsługuje również aliasy interfejsów, to można podać eth0:0, w celu określenia pierwszego aliasu eth0. Można użyć ich do przypisania drugiego adresu. Aby usunąć alias interfejsu należy użyć ifconfig eth0:0 down. Uwaga: w każdym przypadku (tzn. ta sama sieć z połączeniem adresu/maski sieciowej) usuwane są wszystkie aliasy, jeśli usunie się pierwszy (główny).

up

Flaga ta powoduje aktywację interfejsu. Jest pośrednio włączana, gdy interfejsowi nadano nowy adres.

down

Flaga ta powoduje wyłączenie sterownika tego interfejsu.

[-]arp

Włącza lub wyłącza używanie protokołu ARP na tym interfejsie.

[-]promisc

Włącza lub wyłącza tryb promiscous na tym interfejsie. Jeżeli włączony, to wszystkie pakiety w sieci będą przechwytywane przez ten interfejs.

[-]allmulti

Włącza lub wyłącza tryb all-multicast. Jeżeli włączony, to wszystkie pakiety multicast w sieci będą odbierane przez interfejs.

metric N

Parametr ten ustawia metrykę interfejsu.

mtu N

Parametr ten ustawia maksymalną jednostkę transferu (Maximum Transfer Unit) interfejsu.

dstaddr adres

Ustawia adres IP "drugiego końca" w przypadku połączenia point-to-point (takiego jak PPP). Słowo to jest przedawnione, gdyż istnieje nowe słowo, pointopoint

netmask adres

Ustawia maskę sieciową IP dla tego interfejsu. Wartość domyślnie przybiera wartość zwykłej maski sieciowej klasy A, B lub C (jak to wynika z adresu IP interfejsu), lecz może być ustawiona na dowolną wartość.

add adres/dł.prefiksu

Dodaje adres IPv6 do interfejsu.

del adres/dł.prefiksu

Usuwa adres IPv6 z interfejsu.

tunnel aa.bb.cc.dd

Tworzy nowe urządzenie SIT (IPv6-in-IPv4), tworząc tunel do podanego adresu docelowego.

irq adres

Ustawia linię przerwań używaną przez to urządzenie. Nie wszystkie urządzenia obsługują dynamiczne ustawianie IRQ.

io_addr adres

Ustawia początkowy adres w przestrzeni adresowej I/O używany przez to urządzenie.

mem_start adres

Ustawia początkowy adres pamięci dzielonej używany przez to urządzenie. Tylko kilka urządzeń potrzebuje tej opcji.

media typ

Ustawia fizyczny port lub typ nośnika, który ma być używany przez urządzenie. Nie wszystkie urządzenia mogą zmienić to ustawianie, a te które mogą, różnią się wartościami, które obsługują. Typowe wartości parametru typ są następujące: 10base2 (cienki Ethernet), 10baseT (oparty na skrętce 10Mbps Ethernet), AUI (external transceiver) i tak dalej. Specjalny typ auto może być użyty do automatycznego ustawienia nośnika. Jednakże nie wszystkie urządzenia to potrafią.

[-]broadcast [adres]

Jeśli podano także argument adresu, ustawia adres rozgłoszeniowy protokołu na ten interfejs. W przeciwnym wypadku ustawia to tylko flagę IFF_BROADCAST na interfejsie.

[-]pointopoint [adres]

To słowo kluczowe włącza tryb point-to-point interfejsu, który oznacza, że jest to bezpośrednie połączenie między dwoma maszynami, których nikt inny nie podsłuchuje.
Jeśli podano także argument adresu, ustaw adres protokołowy drugiej strony połączenia, tak jak w przedawnionym dstaddr. W przeciwnym wypadku ustawia lub usuwa to tylko flagę IFF_POINTOPOINT interfejsu.

hw klasa adres

Ustawia adres sprzętowy interfejsu, jeśli sterownik obsługuję taką operację. Za słowem tym musi występować nazwa klasy sprzętowej i odczytywalnym w ASCII ekwiwalentem adresu sprzętowego. Obsługiwane obecnie klasy sprzętowe to ether (Ethernet), ax25 (AMPR AX.25), ARCnet i netrom (AMPR NET/ROM).przypisania

multicast

Włącza flagę multicast na interfejsie. Normalnie nie powinno być to potrzebne, gdyż sterowniki ustawiają tę flagę same.

adres

Adres IP przypisany do interfejsu.

txqueuelen długość

Ustawia długość kolejki transmisji dla danego urządzenia. Użyteczne jest ustawienie tego parametru na małą wartość dla wolniejszych urządzeń o dużych opóźnieniach (połączenia modemowe, ISDN), aby zapobiec szybkim masowym transferom generowanym przez na przykład telnet.

UWAGI

Od wersji jądra 2.2 nie są prowadzone statystyki dla aliasów interfejsów. Statystyki wyświetlane dla oryginalnego adresu są dzielone ze wszystkimi aliasami adresów na tym samym urządzeniu. Aby włączyć statystyki dla każdego adresu, należy wyraźnie określić reguły zliczania dla tego adresu za pomocą polecenia ipchains(8) lub iptables(8).

Od net-tools 1.60-4 ifconfig wypisuje liczbę bajtów i jednostki czytelne dla człowieka w jednostkach IEC 60027-2. Tak więc 1 KiB to 2^10 bajtów. Proszę zauważyć, że liczby są zaokrąglone do jednego miejsca po przecinku (co może okazać się znacznym błędem, jeśli weźmie się pod uwagę, że 0.1 PiB to 112.589.990.684.262 bajtów :).

Problemy przerwań sterowników urządzeń Ethernet objawiające się błędem EAGAIN (SIOCSIIFLAGS: Resource temporarily unavailable) wynikają najprawdopodobniej z konfliktów przerwań. Więcej informacji można znaleźć na stronie http://www.scyld.com/expert/irq-conflict.html.

PLIKI

/proc/net/socket
/proc/net/dev
/proc/net/if_inet6

AUTORZY

Fred N. van Kempen, <[email protected]>
Alan Cox, <[email protected]>
Phil Blundell, <[email protected]>
Andi Kleen
Bernd Eckenfels, <[email protected]>

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika man są: Przemek Borys (PTM) <[email protected]>, Robert Luberda (PTM) <[email protected]> i Michał Kułach <[email protected]>.

Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją 1.60 oryginału.