aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/networking/alias.txt
blob: cd12c2ff518a93feb12e4a93b8bad0afaf188de2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

IP-Aliasing:
============

IP-aliases are additional IP-addresses/masks hooked up to a base 
interface by adding a colon and a string when running ifconfig. 
This string is usually numeric, but this is not a must.

IP-Aliases are avail if CONFIG_INET (`standard' IPv4 networking) 
is configured in the kernel.


o Alias creation.
  Alias creation is done by 'magic' interface naming: eg. to create a
  200.1.1.1 alias for eth0 ...
  
    # ifconfig eth0:0 200.1.1.1  etc,etc....
                   ~~ -> request alias #0 creation (if not yet exists) for eth0

    The corresponding route is also set up by this command. 
    Please note: The route always points to the base interface.
	

o Alias deletion.
  The alias is removed by shutting the alias down:

    # ifconfig eth0:0 down
                 ~~~~~~~~~~ -> will delete alias

  		   		   
o Alias (re-)configuring

  Aliases are not real devices, but programs should be able to configure and
  refer to them as usual (ifconfig, route, etc).


o Relationship with main device

  If the base device is shut down the added aliases will be deleted 
  too.


Contact
-------
Please finger or e-mail me:
   Juan Jose Ciarlante <jjciarla@raiz.uncu.edu.ar>

Updated by Erik Schoenfelder <schoenfr@gaertner.DE>

; local variables:
; mode: indented-text
; mode: auto-fill
; end: