projects / people / ms / network.git / blame
| Commit | Line | Data |
|---|---|---|
| de28a630 MT |
1 | .TH network-zone 8 "1 Jun 2012" "@VERSION@" "network man page" |
| 2 | ||
| 3 | .SH NAME | |
| 4 | network-zone \- Network Configuration Control Program | |
| 5 | ||
| 6 | .SH SYNOPSIS | |
| 7 | \fBnetwork [OPTIONS] zone create <zone> ...\fR | |
| 8 | .P | |
| 9 | \fBnetwork [OPTIONS] zone <zone> command ...\fR | |
| 10 | ||
| 11 | .SH DESCRIPTION | |
| 12 | By the zone subcommands, it is very easy to configure network zones. | |
| 13 | .PP | |
| 14 | It is possible to create zones and remove them. Zones may also | |
| 15 | be brought up and down and reconfigured. Their status may be viewed | |
| 16 | as well. | |
| 17 | ||
| 18 | .SH OPTIONS | |
| 19 | The \fBnetwork zone\fR command offers various commands: | |
| 20 | ||
| 21 | \fBcreate <zone> <hook> [options]\fR | |
| 22 | .RS 4 | |
| 23 | A new zone may be created by the \fBcreate\fR command. There are at least two arguments | |
| 24 | required. | |
| 25 | .PP | |
| 26 | \fB<zone>\fR must be valid name for a zone which does not already exist. | |
| 27 | \fB<hook>\fR is a valid zone hook which may require additional options. | |
| 28 | .RE | |
| 29 | .PP | |
| 30 | ||
| 31 | \fBremove <zone>\fR | |
| 32 | .RS 4 | |
| 69ace22b MT |
33 | A zone can be simple removed with this command. |
| 34 | .PP | |
| 35 | There are two possible ways to remove a zone. The case is when the zone is not up. Then, | |
| 36 | it will be removed immediately. When the zone is current up and used, it will tagged | |
| 37 | to be remove later, after it has been brought down. | |
| de28a630 MT |
38 | .RE |
| 39 | .PP | |
| 40 | ||
| 41 | For all other commands, the name of the zone needs to be passed first: | |
| 42 | \fBnetwork zone <zone> command\fR. | |
| 43 | ||
| 44 | \fB<zone> edit [OPTIONS]\fR | |
| 45 | .RS 4 | |
| 46 | The settings of a zone may be edited after it has been created. The options that can | |
| 47 | be passed depend on the hook that is used for the zone. Run \fBnetwork zone <zone> edit --help\fR | |
| 48 | to learn more about that. | |
| 49 | .PP | |
| 50 | It normally is required to restart/reload the zone until the new settings are taken into account. | |
| 51 | .RE | |
| 52 | .PP | |
| 53 | ||
| 54 | \fB<zone> [up|down]\fR | |
| 55 | .RS 4 | |
| 56 | These commands will bring the zone up/down. This is done without control of systemd, therefore | |
| 57 | not intended to be done in a productive environment. However, these commands may be used for | |
| 58 | debugging. | |
| 59 | .RE | |
| 60 | .PP | |
| 61 | ||
| 62 | \fB<zone> status\fR | |
| 63 | .RS 4 | |
| 64 | This will show some detailed information about the state if the specified zone. | |
| 65 | .RE | |
| 66 | .PP | |
| 67 | ||
| 68 | .SH SEE ALSO | |
| 69 | network(8) | |
| 70 | ||
| 71 | .SH AUTHOR | |
| 72 | Michael Tremer (michael.tremer@ipfire.org) |