logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

netctl - Control the netctl network profile manager

Description

netctl may be used to introspect and control the state of the systemd services for the network profile
       manager.

Environment

$NETCTL_DEBUG
           If set to "yes", debugging output is generated.

           The value of this variable is independent of the value of the variable with the same name in
           profiles.

       $NETCTL_STATE_FILE
           The location of the state file. Defaults to /var/lib/netctl/netctl.state.

Exit Status

       On success 0 is returned, a non-zero failure code otherwise.

Name

       netctl - Control the netctl network profile manager

Options

       The following commands are understood:

       list
           List all available profiles. Online profiles will be marked with a ‘*’, otherwise active profiles
           will be marked with a ‘+’.

       store
           Saves which profiles are currently active.

       restore
           Loads the profiles that were active during the last invocation of ‘store’.

       stop-all
           Stops all active network profiles.

       start[PROFILE]
           Start the network profile specified on the command line.

       stop[PROFILE]
           Stop the network profile specified on the command line.

       restart[PROFILE]
           Restart the network profile specified on the command line. If it is not started yet, it will be
           started.

       switch-to[PROFILE]
           Starts the network profile specified on the command line after stopping all profiles that refer to
           the same interface.

       is-active[PROFILE]
           Check whether the network profile specified on the command line is active. Prints the current state.

       status[PROFILE]
           Show terse runtime status information about a profile, followed by its most recent log data from the
           journal.

       enable[PROFILE]
           Enable the systemd unit for the profile specified. This will create a unit configuration file. If the
           file already exists, the command fails. No other profiles than the one specified will be enabled.
           Changes to the general options in a profile specification will not propagate to the unit
           configuration file automatically. After such changes, it is necessary to ‘reenable’ the profile.

       disable[PROFILE]
           Disable the systemd unit for the profile specified. This will remove the file created by ‘enable’
           even if it was customized, so be careful.

       reenable[PROFILE]
           Reenable the systemd unit for the profile specified. This is effectively a combination of ‘disable’
           and ‘enable’.

       is-enabled[PROFILE]
           Check whether the systemd unit for the specified profile is enabled. Prints the current enable
           status.

       edit[PROFILE]
           Open the file of the specified profile in an editor. This does not reenable, restart, or verify any
           profiles.

       verify[PROFILE]
           Check the file of the specified profile for syntax errors. If no errors are found, no output is
           produced.

       wait-online[PROFILE]
           Wait until the interface of the profile has a routable IP address of some kind.

See Also

netctl-auto(1), netctl.profile(5), netctl.special(7), systemctl(1)

                                                   05/27/2024                                          NETCTL(1)

Synopsis

netctl {COMMAND} [PROFILE]

       netctl [--help | --version]

See Also