AddNetInterface
| Formát: | AddNetInterface [QUIET] [TIMEOUT=<n>] INTERFACE |
| Šablona: | INTERFACE/M, QUIET/S, TIMEOUT/K/N |
| Účel: | Zpřístupní síťová pro zásobník protokolů. |
| Cesta: | C:ADDNETINTERFACE |
Příkaz ADDNETINTERFACE spouští zadaná síťová rozhraní, a tím spustí síťové připojení.
Parametry
| INTERFACE/M | Název rozhraní, které chcete přidat. Může to být prostý název rozhraní, například „Ariadne“, nebo zcela kompletní název souboru, který obsahuje informace o konfiguraci rozhraní. Příkaz očekává, že název příslušného souboru (bez předponované cesty) se stane i názvem rozhraní. Z historických důvodů nesmí být názvy rozhraní delší než 15 znaků. Pro vaše pohodlí lze místo názvu souboru použít vzor zástupných znaků. Pokud je zadáno několik názvů rozhraní, budou před jejich přidáním seřazeny podle abecedy. Pokud jsou názvy souborů rozhraní zadány pomocí úplných názvů cest (například "AddNetInterface DEVS:NetInterfaces/~(#?.info) QUIET"), budou zkontrolovány ikony odpovídající souborům; pokud existují nějaké ikony a ikony obsahují typy nástrojů, jako je „PRI=5“, budou rozhraní seřazeny podle těchto priorit. |
| QUIET/S | Tato argument způsobí, že program nezobrazuje žádné chybové zprávy ani zprávy o postupu. Zároveň pokud program narazí na chybu, označí to jako chybový kód 5, na který se lze podívat pomocí příkazu dávkového souboru „if warn“. Pokud tato možnost není použita, chybové kódy budou mnohem častější a zobrazí se všechny informace o průběhu. |
| TIMEOUT/K/N | Pokud se chystáte použít DHCP konfiguraci pro kterékoli rozhraní, výchozí hodnota časového limitu 60 sekund omezí dobu, po kterou může být rozhraní konfigurováno. Tento argument umožňuje použít jinou hodnotu časového limitu. Uvědomte si, že kvůli fungování konfiguračního protokolu nemůže být časový limit kratší než deset sekund. |
Příkaz AddNetInterface lze spustit také z Workbenche. Funguje na stejných konfiguračních souborech se stejnými klíčovými slovy. Aby to vše fungovalo, vytvořte pro váš konfigurační soubor ikonu (musí to být ikona projektu) a vložte příkaz AddNetInterface do výchozího nástroje. Ujistěte se, že projekt má nastaven dostatečně velký v zásobník (minimálně 4000 bajtů), a potom na danou ikonu poklepejte.
Pokud se něco nepovede, zobrazí se vyskakovací okno s informací o chybě a nebude provedena žádná další inicializace. V tooltypech souboru projektu můžete nakonfigurovat dvě možnosti: QUIET a TIMEOUT. Jsou totožné se dvěma parametry stejného jména, které můžete zadat na příkazovém řádku. Ty definují, zda by měl příkaz AddNetInterface zobrazovat chybové zprávy (výchozí je jejich zobrazení) a jak dlouho by měl příkaz čekat na dokončení DHCPkonfigurace (výchozí časový limit je 60 sekund).
Poznámka: Příkaz AddNetInterface je podobný Unixovému příkazu ifconfig.
Program provede dva průchody konfiguračními soubory, které mají být brány v úvahu. V prvním průchodu se shromažďují informace o jednotlivých rozhraních, která se mají přidat. Ty se následně použijí k přidání těchto nalezených rozhraní. V druhém průchodu jsou nakonfigurována nastavení jejich IP adres atd. Pokud se při prvním průchodu něco pokazí, zpracování se zastaví a druhý průchod nebude proveden. Pokud se při prvním nebo druhém průchodu něco pokazí, celá akce nebude dokončena.
Konfigurační soubory
Jednotlivá rozhraní jsou konfigurována prostřednictvím souborů uložených v adresářích „DEVS:NetInterfaces“ nebo „SYS:Storage/NetInterfaces“. Jedná se o textové soubory, jejichž obsah je popsán níže.
Každý řádek v souboru musí odpovídat danému argumentu. Pokud je na začátku řádku znak # nebo ;, bude ignorován. Jsou podporovány následující argumenty:
| DEVICE/K | Tento argument musí být zadán. Název ovladače SANA-IIzařízení. Mělo by se jednat o kompletní cesta k ovladači. Pokud není zadána úplná cesta, bude prohledán adresář „Devs:Networks“. Pro „DEVS:Networks/ariadne.device“ je ekvivalentní zápis „ariadne.device“. | |
| UNIT/K/N | Číslo jednotky ovladače zařízení, které se má otevřít. Výchozí je použití jednotky 0. | |
| IPTYPE/K/N | Tento argument můžete použít k přepsání typu paketu, který zásobník používá při odesílání paketů IP. Výchozí hodnota je 2048 (pro Ethernethardware). | |
| ARPTYPE/K/N | Tento argument lze použít k přepsání typu paketu, který zásobník používá při odesílání ARPpaketů. Výchozí hodnota je 2054. Tento argument funguje pouze s Ethernethardwarem a neměl by být měněn. | |
| IPREQUESTS/K/N | Počet požadavků na čtení IP, které mají být přiděleny a zařazeny do fronty pro použití ovladače SANA-IIzařízení. Výchozí hodnota je 32, větší hodnoty mohou zlepšit výkon, zejména u rychlých ovladačů zařízení. | |
| WRITEREQUESTS/K/N | Počet požadavků na zápis IP pro přidělení a frontu pro použití ovladače SANA-IIzařízení. Výchozí hodnota je 32, větší hodnoty mohou zlepšit výkon, zejména u rychlých ovladačů zařízení. | |
| ARPREQUESTS/K/N | Počet požadavků na čtení ARP pro přidělení a frontu pro použití ovladače SANA-IIzařízení. Výchozí hodnota je 4. | |
| DEBUG/K | Povoluje ladicí výstup pro dané rozhraní (nebojte se, vždy ho můžete později zakázat), abyste si pomohli při hledání problémů s konfigurací. V současné chvíli ladící režim generuje informace o průběhu procesu DHCPkonfigurace. | |
| POINTTOPOINT/K | Použití tohoto argumentu znamená, že zařízení je používáno pro point-to-point připojení. Stack automaticky zjistí, zda je ovladač SANA-IIzařízení typu point-to-point, takže tuto možnost nemusíte zadávat. | |
| MULTICAST/K | Tento argument oznamuje stacku, že toto zařízení může zpracovávat pakety vícesměrového vysílání. Volba YES funguje pouze s Ethernethardwarem (kde je přesto ve výchozím nastavení povoleno). | |
| DOWNGOESOFFLINE/K | Tento argument je užitečný u zařízení typu point-to-point, například ppp.device. Pokud je použit, pak snížení úrovně rozhraní (pomocí programu „ConfigureNetInterface“) nebo vypnutí stacku způsobí přepnutí přidruženého ovladače SANA-IIzařízení do offline (příkazem „S2_OFFLINE“). | |
| REQUIRESINITDELAY/K | Některá zařízení potřebují trochu času po otevření, nebo se zaseknou a ztratí data po odeslání prvního paketu. Původní karta Ariadne I je přesně takové zařízení. U těchto zařízení způsobí argument 'REQUIRESINITDELAY=YES' zpoždění asi o sekundu před odesláním prvního paketu. Výchozí nastavení tohoto argumentu je na YES. |
|
| COPYMODE/K | Tento argument slouží k hledání drobných chyb v rozhraní ovladače a síťových karet jako je původní Ariadne I. Karty jako tyto nepodporují zápis do hardwarové vyrovnávací paměti v jednotkách jiných než 16 bitů. Výchozí hodnota je „SLOW“, která je kompatibilní s kartou Ariadne I. Ale pokud jste dobrodruh, zkuste volbu „FAST“ (a nestěžujte si, pokud to nebude fungovat!). | |
| FILTER/K | Tento argument umožňuje použití filtru paketů Berkeley pro konkrétní rozhraní. Možné volby jsou: | |
| FILTER=OFF | Vypne filtr. | |
| FILTER=LOCAL | Umožňuje filtrování na všech IP a ARP paketech, které jsou určeny pro konkrétní rozhraní. Pakety určené pro jiná rozhraní nebo počítače jsou ignorovány. | |
| FILTER=IPANDARP | Umožňuje filtrování na všech IP a ARP paketech, které tímto rozhraním procházejí, bez ohledu na to, zda jsou pakety určeny pro toto rozhraní nebo ne. To vyžaduje aby byl základní ovladač síťového zařízení otevřen pro výhradní přístup v takzvaném „promiskuitním“ režimu. To nemusí fungovat, pokud ostatní klienti (Envoy, ACS) musí mít ovladač otevřený. | |
| FILTER=EVERYTHING | Stejné jako FILTER=IPANDARP, ale také filtruje všechny ostatní druhy paketů, které se mohou zobrazit. | |
| Výchozí nastavení pro tento argument je FILTER=LOCAL. Všimněte si, že pomocí této možnosti pouze definujete, co může a nemůže mechanismus filtru dělat. Po přidání rozhraní není filtr povolen. | ||
| HARDWAREADDRESS/K | Můžete určit hardwarovou adresu (adresa vrstvy 2, MACadresa), na kterou by toto rozhraní mělo reagovat při prvním přidání a konfiguraci. To obvykle funguje pouze jednou pro každé rozhraní, což znamená, že jakmile je vybrána adresa, musíte se jí držet, dokud nebude systém restartován. A také to znamená, že první program, který nakonfiguruje adresu, zvládne, aby se její volba zachovala. Hardwarová adresa musí být zadána jako šest bajtů v hexadecimálním zápisu, oddělených znaky dvojtečky, například: HARDWAREADDRESS=00:60:30:00:11:22 Dejte si pozor, existují určitá pravidla, která platí pro výběr hardwarové adresy. To znamená, že nemůžete jednoduše vybrat náhodné číslo a použít ho. Předpokládá se, že budete chtít nakonfigurovat MAC adresu podle specifikace IEEE 802.3, která pracuje pro Ethernethardware a má velikost šest bajtů (48 bitů). |
|
Kromě informací o konfiguraci čistě statického rozhraní můžete konfiguračnímu programu také sdělit, aby něco udělal s rozhraními, jakmile budou všechna přidána. V takovém případě budou brány v úvahu následující parametry konfiguračního souboru:
| ADDRESS/K | Tento argument nastavuje IP adresu rozhraní. Parametr, který zadáte, by měla být IP adresa v desetinné tečkové notaci (192.168.0.1). Nevybírejte symbolické jméno hostitele, protože systém ještě nemusí být schopen hovořit se serverem pro rozlišení jmen a překládat symbolické jméno. Místo IP adresy můžete také zadat DHCP (Dynamic Host Configuration Protocol). Jak název napovídá, zahájí se proces konfigurace zahrnující DHCP protokol, který by měl nakonec dát tomuto hostiteli správnou IP adresu. Tento postup konfigurace funguje pouze pro Ethernethardware. |
|
| ALIAS/K/M | Kromě adresy primárního rozhraní k ní můžete přiřadit několik aliasů. Tyto údaje musí být uvedeny v desítkové soustavě s desetinnými tečkami (192.168.0.1). Alias adresy jsou přidány po nakonfigurování adresy primárního rozhraní. | |
| STATE/K | Ve výchozím nastavení se rozhraní, jejichž adresy jsou nakonfigurovány, automaticky přepnou do stavu „zapnuto“, což jim umožní TCP/IP stack použít pro síťové operace. Můžete to přepsat pomocí přepínače STATE=DOWN. | |
| NETMASK/K | Tímto argumentem vyberete masku podsítě rozhraní, která musí být specifikována v desítkové soustavě s desetinnými tečkami (192.0.168.1). Místo masky podsítě můžete také zadat DHCP (Dynamic Host Configuration Protocol). Jak název napovídá, zahájí se proces konfigurace zahrnující DHCPprotokol, který by měl nakonec dát tomuto hostiteli správnou masku podsítě. Tento postup konfigurace funguje pouze pro Ethernethardware. |
|
| DESTINATION=DESTINATIONADDR/K | Adresa point-to-point partnera pro toto rozhraní. Musí být uvedeno v desetinné tečce (192.168.0.1). Funguje pouze pro point-to-pointpřipojení, například PPP. | |
| METRIC/K/N | Tímto argumentem se konfiguruje metrická hodnota trasy rozhraní. Výchozí hodnota je 0. | |
| MTU/K/N | Můžete omezit maximální velikostpřenosu, kterou používá TCP/IP stack pro posílání dat přes dané rozhraní. Ovladač rozhraní bude mít své vlastní představy o maximální přenosové velikosti. Můžete proto navrhnout pouze menší hodnotu, než je preferovaná velikost MTUhardwaru ovladače. | |
| CONFIGURE/K | Pro toto rozhraní můžete použít DHCPkonfiguraci, konkrétně seznam routerů (a výchozí brány), které se mají použít, a servery názvů domén. Tato možnost umožňuje vyvolat úplnou konfiguraci sítě v jediném kroku. Můžete požádat o přiřazení určité IP adresy tomuto rozhraní pomocí DHCPprocesu zadáním CONFIGURE=DHCP a vaší adresy ADDRESS=xxx.xxx.xxx.xxx. |
|
| LEASE/K | Toto je složitý argument, kterým lze pomocí protokolu DHCP požádat o to, jak dlouho by měla být IP adresa navázána na dané rozhraní. Je možné několik kombinací. Zde je krátký seznam: | |
| LEASE=300 LEASE=300seconds |
Požaduje rezervaci přesně na 300 sekund nebo pět minut. | |
| LEASE=30min | Požaduje rezervaci přesně na 30 minut. | |
| LEASE=2hours | Požaduje rezervaci přesně na dvě hodiny. | |
| LEASE=1day | Požaduje rezervaci přesně na jeden den. | |
| LEASE=4weeks | Požaduje rezervaci přesně na čtyři týdny. |
|
| LEASE=infinite | Požaduje, aby IP adresa byla pevně navázána. | |
| ID/K | Tento argument spolupracuje s procesem CONFIGURE=DHCP. Lze jej použít k tomu, aby se DHCP serveru sdělilo, pod jakým názvem by měl být odkazován místní hostitel. Název, který zde můžete zadat, nesmí být delší než 255 znaků a musí být dlouhý alespoň 2 znaky. Zachovejte jednoduchost: ne všechny DHCPservery mají prostor pro celých 255 znaků. | |
V konfiguračním souboru budou hlášeny nepodporovaná klíčová slova (nebo překlepy) spolu s názvem souboru a číslem řádku.
Název konfiguračního souboru definuje název příslušného rozhraní. Názvy rozhraní musí být jedinečné a velikost písmen nehraje roli. Z historických důvodů nesmí být názvy rozhraní delší než 15 znaků. Kromě toho neplatí žádná omezení pro jejich pojmenování.
PROTOKOL DHCP
Pár slov ohledně DHCP (Dynamic Host Configuration Protocol). Za prvé, funguje to pouze pro Ethernet hardware, takže to prosím nezkoušejte pomocí PPP nebo SLIP spojení. Teď to bude trochu technické.
Pokud nepožádáte o trvalé přiřazení adresy, DHCP přiřadí danou IP adresu pouze po omezenou dobu. Tomu se říká „pronájem“.
Jakmile je prostřednictvím DHCP přidělena IP adresa, bude pronájem opakovaně prodlužován. DHCP server se však může časem rozhodnout, že znovu neprodlouží pronájem IP adresy a přidělí danému rozhraní novou. Chcete-li zabránit opětovnému prodloužení pronájmu IP adresy, musíte buď změnit primární IP adresu rozhraní nebo ji označit spojení vypnout. Knihovna provede odvážný pokus o získání DHCPRELEASEdatagramu a upozorní server, že dříve přidělená adresa IP se již nepoužívá. Nepočítejte však s tím, že to bude fungovat. Za prvé, protokol vypnutí stacku může proběhnout tak rychle, že se nepodaří tento datagram získat. Za druhé, když označíte rozhraní jako vypnuté, efektivně jej vyjmete z používání. Proto už nebude posílat žádné další datagramy. Za třetí, DHCP jede na UDP, jehož druhé jméno je „nespolehlivý protokol datagramu“, což znamená, že jakýkoli datagram se může ztratit nebo poškodit a nikdo se o tom ani nedozví. To je na DHCP poměrně obtížné, protože zpráva o uvolnění je odeslána pouze jednou.
Nebojte se. Pokud si nepožádáte o trvalý pronájem, tak nakonec vyprší a aktuálně nepoužívaná IP adresa se konečně vrátí do skupiny adres, které jsou k dispozici pro přidělování.
Příklad
Spustí rozhraní s názvem DSL a poběží potichu.
| 1> AddNetInterface DSL QUIET |
Příklad konfiguračního souboru pro rozhraní „Ariadne“ s některými komentovanýmimožnostmi:
| 1> Type Devs:NetInterfaces/Ariadne device=ariadne.device unit=0 #iprequests=64 #writerequests=64 copymode=fast #configure=dhcp address=192.168.0.1 netmask=255.255.255.0 #alias=192.168.0.9 #hardwareaddress=00:60:30:00:11:22 #id=a3000ux #debug=yes #filter=everything |
