config, man: hide connectivity-check command-line options

There is no reason to configure the connectivity-check options from
the command line rather than from the config file. Keep the options,
for backward-compatibility, but remove them from the man page and hide
them from --help.
This commit is contained in:
Dan Winship 2013-03-14 09:23:21 -04:00
parent 8bb9ee8d3b
commit 29ed892de7
2 changed files with 6 additions and 21 deletions

View file

@ -10,7 +10,7 @@ NetworkManager \- network management daemon
.SH SYNOPSIS
.B NetworkManager [\-\-version] | [\-\-help]
.PP
.B NetworkManager [\-\-no\-daemon] [\-\-pid\-file=<filename>] [\-\-state\-file=<filename>] [\-\-config=<filename>] [\-\-plugins=<plugin1>,plugin2>,...] [\-\-log\-level=<level>] [\-\-log\-domains=<domain1>,<domain2>,...] [\-\-connectivity\-uri=<uri>] [\-\-connectivity\-interval=<int>] [\-\-connectivity\-response=<resp>]
.B NetworkManager [\-\-no\-daemon] [\-\-pid\-file=<filename>] [\-\-state\-file=<filename>] [\-\-config=<filename>] [\-\-plugins=<plugin1>,plugin2>,...] [\-\-log\-level=<level>] [\-\-log\-domains=<domain1>,<domain2>,...]
.SH DESCRIPTION
The \fINetworkManager\fP daemon attempts to make networking configuration and
operation as painless and automatic as possible by managing the primary network
@ -118,23 +118,6 @@ log levels and domains.
Sets which operations are logged to the log destination (usually syslog). By
default, most domains are logging-enabled. See \fBNetworkManager.conf\fP(5) for
more information on log levels and domains.
.TP
.I "\-\-connectivity\-uri=<uri>
Sets the URI of a web page that will be used for connectivity checking. By
default connectivity checking is disabled. See \fBNetworkManager.conf\fP(5)
[connectivity] section for more information on connectivity checking feature.
.TP
.I "\-\-connectivity\-interval=<int>
Sets the interval (in seconds) in which connection checks for the URI are done.
0 means no checks. The default value is 300 seconds. See
\fBNetworkManager.conf\fP(5) [connectivity] section for more information on
connectivity checking feature.
.TP
.I "\-\-connectivity\-response=<resp>
If set, it controls what body content NetworkManager checks for when requesting
the URI for connectivity checking. If missing, defaults to "NetworkManager is online".
See \fBNetworkManager.conf\fP(5) [connectivity] section for more information on
connectivity checking feature.
.SH DEBUGGING
The following environment variables are supported to help debugging. When used

View file

@ -143,9 +143,11 @@ static GOptionEntry config_options[] = {
{ "log-domains", 0, 0, G_OPTION_ARG_STRING, &cli_log_domains,
N_("Log domains separated by ',': any combination of [%s]"),
"PLATFORM,RFKILL,WIFI" },
{ "connectivity-uri", 0, 0, G_OPTION_ARG_STRING, &cli_connectivity_uri, N_("An http(s) address for checking internet connectivity"), "http://example.com" },
{ "connectivity-interval", 0, 0, G_OPTION_ARG_INT, &cli_connectivity_interval, N_("The interval between connectivity checks (in seconds)"), "60" },
{ "connectivity-response", 0, 0, G_OPTION_ARG_STRING, &cli_connectivity_response, N_("The expected start of the response"), N_("Bingo!") },
/* These three are hidden for now, and should eventually just go away. */
{ "connectivity-uri", 0, G_OPTION_FLAG_HIDDEN, G_OPTION_ARG_STRING, &cli_connectivity_uri, N_("An http(s) address for checking internet connectivity"), "http://example.com" },
{ "connectivity-interval", 0, G_OPTION_FLAG_HIDDEN, G_OPTION_ARG_INT, &cli_connectivity_interval, N_("The interval between connectivity checks (in seconds)"), "60" },
{ "connectivity-response", 0, G_OPTION_FLAG_HIDDEN, G_OPTION_ARG_STRING, &cli_connectivity_response, N_("The expected start of the response"), N_("Bingo!") },
{NULL}
};
static gboolean config_options_inited;