Merge branch 'master' of master.kernel.org:/pub/scm/linux/kernel/git/torvalds/linux-2.6
[linux-2.6] / Documentation / networking / alias.txt
1
2 IP-Aliasing:
3 ============
4
5 IP-aliases are additional IP-addresses/masks hooked up to a base 
6 interface by adding a colon and a string when running ifconfig. 
7 This string is usually numeric, but this is not a must.
8
9 IP-Aliases are avail if CONFIG_INET (`standard' IPv4 networking) 
10 is configured in the kernel.
11
12
13 o Alias creation.
14   Alias creation is done by 'magic' interface naming: eg. to create a
15   200.1.1.1 alias for eth0 ...
16   
17     # ifconfig eth0:0 200.1.1.1  etc,etc....
18                    ~~ -> request alias #0 creation (if not yet exists) for eth0
19
20     The corresponding route is also set up by this command. 
21     Please note: The route always points to the base interface.
22         
23
24 o Alias deletion.
25   The alias is removed by shutting the alias down:
26
27     # ifconfig eth0:0 down
28                  ~~~~~~~~~~ -> will delete alias
29
30                                    
31 o Alias (re-)configuring
32
33   Aliases are not real devices, but programs should be able to configure and
34   refer to them as usual (ifconfig, route, etc).
35
36
37 o Relationship with main device
38
39   If the base device is shut down the added aliases will be deleted 
40   too.
41
42
43 Contact
44 -------
45 Please finger or e-mail me:
46    Juan Jose Ciarlante <jjciarla@raiz.uncu.edu.ar>
47
48 Updated by Erik Schoenfelder <schoenfr@gaertner.DE>
49
50 ; local variables:
51 ; mode: indented-text
52 ; mode: auto-fill
53 ; end: