]> git.ipfire.org Git - network.git/blob - man/network-zone.txt
Makefile: Fix typo in localstatedir
[network.git] / man / network-zone.txt
1 = network-zone(8)
2
3 == NAME
4 network-zone - Manage network zones
5
6 == SYNOPSIS
7 [verse]
8 'network zone [new|destroy]' ZONE
9 'network zone' ZONE ...
10
11 == DESCRIPTION
12 With help of the 'zone' command, it is very easy to configure network zones.
13
14 It is possible to create zones and remove them. Zones may also be brought up
15 and down and reconfigured. Their status may be viewed as well.
16
17 == COMMANDS
18 The following commands are understood:
19
20 'new ZONE HOOK OPTIONS'::
21 A new zone may be created by the 'create' command.
22 There are at least two arguments required.
23 +
24 ZONE must be valid name for a zone which does not already exist.
25 HOOK is a valid zone hook which may require additional options.
26
27 'destroy ZONE'::
28 A zone can be destroyed with this command.
29 +
30 There are two possible ways to remove a zone. The case is when the zone is
31 not up. Then, it will be removed immediately. When the zone is current up
32 and used, it will tagged to be remove later, after it has been brought down.
33
34 For all other commands, the name of the zone needs to be passed first:
35
36 'edit OPTIONS'::
37 The settings of a zone may be edited after it has been created.
38 The options that can be passed depend on the hook that is used for the zone.
39 Run 'network zone ZONE edit --help' to learn more about that.
40 +
41 It usually is required to restart/reload the zone until the new settings
42 are taken into account.
43
44 '[up|down]'::
45 These commands will bring the zone up/down. This is done without control
46 of systemd, therefore not intended to be done in a productive environment.
47 However, these commands may be used for debugging.
48
49 '[enable|disable]'::
50 These commands will enable or disable the zone. An enabled zone will
51 automatically be started either during the boot process or a hotplug event
52 of an associated port or other device.
53
54 'status'::
55 This will show some detailed information about the state if the specified zone.
56
57 include::include-color.txt[]
58
59 include::include-description.txt[]
60
61 'identify'::
62 This command will make all ports of the zone flash for a few seconds so
63 that you can identify the correct network adapters in the system.
64
65 'rename' NAME::
66 Renames the zone to NAME.
67 +
68 The command will shut down the zone if it is up and start it again with
69 the new name. If the zone is not up it won't be started.
70
71 == AUTHORS
72 Michael Tremer
73
74 == SEE ALSO
75 link:network[8]