diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/Makefile.am | 17 | ||||
| -rw-r--r-- | man/Makefile.in | 611 | ||||
| -rw-r--r-- | man/NetworkManager.8 | 108 | ||||
| -rw-r--r-- | man/NetworkManager.8.in | 108 | ||||
| -rw-r--r-- | man/NetworkManager.conf.5 | 139 | ||||
| -rw-r--r-- | man/NetworkManager.conf.5.in | 139 | ||||
| -rw-r--r-- | man/nm-system-settings.conf.5 | 26 | ||||
| -rw-r--r-- | man/nm-system-settings.conf.5.in | 26 | ||||
| -rw-r--r-- | man/nm-tool.1 | 17 | ||||
| -rw-r--r-- | man/nm-tool.1.in | 17 | ||||
| -rw-r--r-- | man/nmcli.1 | 321 | ||||
| -rw-r--r-- | man/nmcli.1.in | 321 |
12 files changed, 1850 insertions, 0 deletions
diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 00000000..097fdc6b --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,17 @@ +man_MANS = \ + NetworkManager.8 \ + NetworkManager.conf.5 \ + nm-system-settings.conf.5 \ + nm-tool.1 \ + nmcli.1 + +EXTRA_DIST = \ + $(man_MANS) \ + NetworkManager.8.in \ + NetworkManager.conf.5.in \ + nm-system-settings.conf.5.in \ + nm-tool.1.in \ + nmcli.1.in + +CLEANFILES = $(man_MANS) + diff --git a/man/Makefile.in b/man/Makefile.in new file mode 100644 index 00000000..6f300937 --- /dev/null +++ b/man/Makefile.in @@ -0,0 +1,611 @@ +# Makefile.in generated by automake 1.11.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, +# Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +subdir = man +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ + $(srcdir)/NetworkManager.8.in \ + $(srcdir)/NetworkManager.conf.5.in \ + $(srcdir)/nm-system-settings.conf.5.in $(srcdir)/nm-tool.1.in \ + $(srcdir)/nmcli.1.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/compiler_warnings.m4 \ + $(top_srcdir)/m4/gtk-doc.m4 $(top_srcdir)/m4/intltool.m4 \ + $(top_srcdir)/m4/libnl-check.m4 $(top_srcdir)/m4/libtool.m4 \ + $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ + $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = NetworkManager.8 NetworkManager.conf.5 \ + nm-system-settings.conf.5 nm-tool.1 nmcli.1 +CONFIG_CLEAN_VPATH_FILES = +SOURCES = +DIST_SOURCES = +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`; +am__install_max = 40 +am__nobase_strip_setup = \ + srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` +am__nobase_strip = \ + for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" +am__nobase_list = $(am__nobase_strip_setup); \ + for p in $$list; do echo "$$p $$p"; done | \ + sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ + $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ + if (++n[$$2] == $(am__install_max)) \ + { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ + END { for (dir in files) print dir, files[dir] }' +am__base_list = \ + sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ + sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' +man1dir = $(mandir)/man1 +am__installdirs = "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" \ + "$(DESTDIR)$(man8dir)" +man5dir = $(mandir)/man5 +man8dir = $(mandir)/man8 +NROFF = nroff +MANS = $(man_MANS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +ACLOCAL_AMFLAGS = @ACLOCAL_AMFLAGS@ +ALL_LINGUAS = @ALL_LINGUAS@ +AMTAR = @AMTAR@ +AR = @AR@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CATALOGS = @CATALOGS@ +CATOBJEXT = @CATOBJEXT@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DATADIRNAME = @DATADIRNAME@ +DBUS_CFLAGS = @DBUS_CFLAGS@ +DBUS_LIBS = @DBUS_LIBS@ +DBUS_SYS_DIR = @DBUS_SYS_DIR@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DHCLIENT_PATH = @DHCLIENT_PATH@ +DHCPCD_PATH = @DHCPCD_PATH@ +DISABLE_DEPRECATED = @DISABLE_DEPRECATED@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ +GIO_CFLAGS = @GIO_CFLAGS@ +GIO_LIBS = @GIO_LIBS@ +GLIB_CFLAGS = @GLIB_CFLAGS@ +GLIB_GENMARSHAL = @GLIB_GENMARSHAL@ +GLIB_LIBS = @GLIB_LIBS@ +GMODULE_CFLAGS = @GMODULE_CFLAGS@ +GMODULE_LIBS = @GMODULE_LIBS@ +GMOFILES = @GMOFILES@ +GMSGFMT = @GMSGFMT@ +GNUTLS_CFLAGS = @GNUTLS_CFLAGS@ +GNUTLS_LIBS = @GNUTLS_LIBS@ +GREP = @GREP@ +GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_MKPDF = @GTKDOC_MKPDF@ +GTKDOC_REBASE = @GTKDOC_REBASE@ +GUDEV_CFLAGS = @GUDEV_CFLAGS@ +GUDEV_LIBS = @GUDEV_LIBS@ +HTML_DIR = @HTML_DIR@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INSTOBJEXT = @INSTOBJEXT@ +INTLLIBS = @INTLLIBS@ +INTLTOOL_EXTRACT = @INTLTOOL_EXTRACT@ +INTLTOOL_MERGE = @INTLTOOL_MERGE@ +INTLTOOL_PERL = @INTLTOOL_PERL@ +INTLTOOL_UPDATE = @INTLTOOL_UPDATE@ +IPTABLES_PATH = @IPTABLES_PATH@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBDL = @LIBDL@ +LIBGCRYPT_CFLAGS = @LIBGCRYPT_CFLAGS@ +LIBGCRYPT_CONFIG = @LIBGCRYPT_CONFIG@ +LIBGCRYPT_LIBS = @LIBGCRYPT_LIBS@ +LIBM = @LIBM@ +LIBNL_CFLAGS = @LIBNL_CFLAGS@ +LIBNL_LIBS = @LIBNL_LIBS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MKDIR_P = @MKDIR_P@ +MKINSTALLDIRS = @MKINSTALLDIRS@ +MSGFMT = @MSGFMT@ +MSGFMT_OPTS = @MSGFMT_OPTS@ +MSGMERGE = @MSGMERGE@ +NM = @NM@ +NMEDIT = @NMEDIT@ +NSS_CFLAGS = @NSS_CFLAGS@ +NSS_LIBS = @NSS_LIBS@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PKG_CONFIG = @PKG_CONFIG@ +POFILES = @POFILES@ +POLKIT_CFLAGS = @POLKIT_CFLAGS@ +POLKIT_LIBS = @POLKIT_LIBS@ +POSUB = @POSUB@ +PO_IN_DATADIR_FALSE = @PO_IN_DATADIR_FALSE@ +PO_IN_DATADIR_TRUE = @PO_IN_DATADIR_TRUE@ +PPPD_PLUGIN_DIR = @PPPD_PLUGIN_DIR@ +RANLIB = @RANLIB@ +RESOLVCONF_PATH = @RESOLVCONF_PATH@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +SYSTEM_CA_PATH = @SYSTEM_CA_PATH@ +UDEV_BASE_DIR = @UDEV_BASE_DIR@ +USE_NLS = @USE_NLS@ +UUID_CFLAGS = @UUID_CFLAGS@ +UUID_LIBS = @UUID_LIBS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +lt_ECHO = @lt_ECHO@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +man_MANS = \ + NetworkManager.8 \ + NetworkManager.conf.5 \ + nm-system-settings.conf.5 \ + nm-tool.1 \ + nmcli.1 + +EXTRA_DIST = \ + $(man_MANS) \ + NetworkManager.8.in \ + NetworkManager.conf.5.in \ + nm-system-settings.conf.5.in \ + nm-tool.1.in \ + nmcli.1.in + +CLEANFILES = $(man_MANS) +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu man/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu man/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): +NetworkManager.8: $(top_builddir)/config.status $(srcdir)/NetworkManager.8.in + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ +NetworkManager.conf.5: $(top_builddir)/config.status $(srcdir)/NetworkManager.conf.5.in + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ +nm-system-settings.conf.5: $(top_builddir)/config.status $(srcdir)/nm-system-settings.conf.5.in + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ +nm-tool.1: $(top_builddir)/config.status $(srcdir)/nm-tool.1.in + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ +nmcli.1: $(top_builddir)/config.status $(srcdir)/nmcli.1.in + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs +install-man1: $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" + @list=''; test -n "$(man1dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \ + done; } + +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man1dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man1dir)" && rm -f $$files; } +install-man5: $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man5dir)" || $(MKDIR_P) "$(DESTDIR)$(man5dir)" + @list=''; test -n "$(man5dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.5[a-z]*$$/p'; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man5dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man5dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man5dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man5dir)" || exit $$?; }; \ + done; } + +uninstall-man5: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man5dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.5[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man5dir)" && rm -f $$files; } +install-man8: $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man8dir)" || $(MKDIR_P) "$(DESTDIR)$(man8dir)" + @list=''; test -n "$(man8dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.8[a-z]*$$/p'; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man8dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man8dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man8dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man8dir)" || exit $$?; }; \ + done; } + +uninstall-man8: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man8dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.8[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man8dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man8dir)" && rm -f $$files; } +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @list='$(MANS)'; if test -n "$$list"; then \ + list=`for p in $$list; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ + if test -n "$$list" && \ + grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ + echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ + grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ + echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ + echo " typically \`make maintainer-clean' will remove them" >&2; \ + exit 1; \ + else :; fi; \ + else :; fi + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(MANS) +installdirs: + for dir in "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"; do \ + test -z "$$dir" || $(MKDIR_P) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES) + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: install-man + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: install-man1 install-man5 install-man8 + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-man + +uninstall-man: uninstall-man1 uninstall-man5 uninstall-man8 + +.MAKE: install-am install-strip + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + distclean distclean-generic distclean-libtool distdir dvi \ + dvi-am html html-am info info-am install install-am \ + install-data install-data-am install-dvi install-dvi-am \ + install-exec install-exec-am install-html install-html-am \ + install-info install-info-am install-man install-man1 \ + install-man5 install-man8 install-pdf install-pdf-am \ + install-ps install-ps-am install-strip installcheck \ + installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic \ + mostlyclean-libtool pdf pdf-am ps ps-am uninstall uninstall-am \ + uninstall-man uninstall-man1 uninstall-man5 uninstall-man8 + + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/man/NetworkManager.8 b/man/NetworkManager.8 new file mode 100644 index 00000000..a6be0731 --- /dev/null +++ b/man/NetworkManager.8 @@ -0,0 +1,108 @@ +.\" NetworkManager(8) manual page +.\" +.\" Copyright (C) 2005 - 2010 Red Hat, Inc. +.\" Copyright (C) 2005 - 2009 Novell, Inc. +.\" Copyright (C) 2005 Robert Love +.\" +.TH NETWORKMANAGER "8" "January 29, 2010" +.SH NAME +NetworkManager \- network management daemon +.SH SYNOPSIS +.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 +connection and other network interfaces, like Ethernet, WiFi, and Mobile +Broadband devices. NetworkManager will connect any network device when a +connection for that device becomes available, unless that behavior is disabled. +Information about networking is exported via a D-Bus interface to any interested +application, providing a rich API with which to inspect and control network +settings and operation. +.P +NetworkManager will execute scripts in the /etc/NetworkManager/dispatcher.d +directory in alphabetical order in response to network events. Each script +should be (a) a regular file, (b) owned by root, (c) not writable by group or +other, (d) not set-uid, (e) and executable by the owner. Each script receives +two arguments, the first being the interface name of the device just activated, +and second an action. +.TP +.I "up" +The interface has been activated. The environment contains more information +about the interface; CONNECTION_UUID contains the UUID of the connection. Other +variables are IP4_ADDRESS_N where N is a number from 0 to (# IPv4 addresses \- 1), +in the format "address/prefix gateway". IP4_NUM_ADDRESSES contains the number +addresses the script may expect. IP4_NAMESERVERS contains a space-separated +list of the DNS servers, and IP4_DOMAINS contains a space-separated list of the +search domains. Routes use the format IP4_ROUTE_N where N is a number from 0 +to (# IPv4 routes \- 1), in the format "address/prefix next-hop metric", and +IP4_NUM_ROUTES contains the number of routes to expect. If the connection used +DHCP for address configuration, the received DHCP configuration is passed in the +environment using standard DHCP option names, prefixed with "DHCP4_", like +"DHCP4_HOST_NAME=foobar". +.TP +.I "down" +The interface has been deactivated. +.TP +.I "vpn\-up" +A VPN connection has been activated. The environment contains the connection +UUID in the variable CONNECTION_UUID. +.TP +.I "vpn\-down" +A VPN connection has been deactivated. +.TP +.I "hostname" +The system hostname has been updated. Use gethostname(2) to retrieve it. +.SH OPTIONS +The following options are supported: +.TP +.I "\-\-no\-daemon" +Do not daemonize. This is useful for debugging, and directs log output to the +controlling terminal in addition to syslog. +.TP +.I "\-\-pid\-file=<filename>" +Specify location of a PID file. The PID file is used for storing PID of the +running proccess and prevents running multiple instances. +.TP +.I "\-\-state\-file=<filename>" +Specify file for storing state of the NetworkManager persistently. If not specified, +the default value of '<LOCALSTATEDIR>/lib/NetworkManager/NetworkManager.state' is +used; where <LOCALSTATEDIR> is dependent on your distribution (usually it's /var). +.TP +.I "\-\-config=<filename>" +Specify configuration file to set up various settings for NetworkManager. If not +specified, the default value of '<SYSCONFDIR>/NetworkManager/NetworkManager.conf' +is used with a fallback to the older 'nm\-system\-settings.conf' if located in +the same directory; where <SYSCONFDIR> is dependent on your distribution (usually +it's /etc). See \fBNetworkManager.conf\fP(5) for more information on configuration +file. +.TP +.I "\-\-plugins=<plugin1>,<plugin2>, ... +List plugins used to manage system-wide connection settings. This list has +preference over plugins specified in the configuration file. Currently supported +plugins are: keyfile, ifcfg\-rh, ifcfg\-suse, ifupdown. +See \fBNetworkManager.conf\fP(5) for more information on the plugins. +.TP +.I "\-\-log\-level=<level> +Sets how much information NetworkManager sends to the log destination (usually +syslog's "daemon" facility). By default, only informational, warning, and error +messages are logged. See \fBNetworkManager.conf\fP(5) for more information on +log levels and domains. +.TP +.I "\-\-log\-domains=<domain1>,<domain2>, ... +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. +.SH DEBUGGING +The following environment variables are supported to help debugging. When used +in conjunction with the "\-\-no\-daemon" option (thus echoing PPP and DHCP helper +output to stdout) these can quickly help pinpoint the source of connection +issues. Also see the \-\-log\-level and \-\-log\-domains to enable debug logging inside +NetworkManager itself. +.TP +.I "NM_PPP_DEBUG" +When set to anything, causes NetworkManager to turn on PPP debugging in pppd, +which logs all PPP and PPTP frames and client/server exchanges. +.SH SEE ALSO +.BR nm\-tool (1), +.BR NetworkManager.conf (5). + diff --git a/man/NetworkManager.8.in b/man/NetworkManager.8.in new file mode 100644 index 00000000..a6be0731 --- /dev/null +++ b/man/NetworkManager.8.in @@ -0,0 +1,108 @@ +.\" NetworkManager(8) manual page +.\" +.\" Copyright (C) 2005 - 2010 Red Hat, Inc. +.\" Copyright (C) 2005 - 2009 Novell, Inc. +.\" Copyright (C) 2005 Robert Love +.\" +.TH NETWORKMANAGER "8" "January 29, 2010" +.SH NAME +NetworkManager \- network management daemon +.SH SYNOPSIS +.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 +connection and other network interfaces, like Ethernet, WiFi, and Mobile +Broadband devices. NetworkManager will connect any network device when a +connection for that device becomes available, unless that behavior is disabled. +Information about networking is exported via a D-Bus interface to any interested +application, providing a rich API with which to inspect and control network +settings and operation. +.P +NetworkManager will execute scripts in the /etc/NetworkManager/dispatcher.d +directory in alphabetical order in response to network events. Each script +should be (a) a regular file, (b) owned by root, (c) not writable by group or +other, (d) not set-uid, (e) and executable by the owner. Each script receives +two arguments, the first being the interface name of the device just activated, +and second an action. +.TP +.I "up" +The interface has been activated. The environment contains more information +about the interface; CONNECTION_UUID contains the UUID of the connection. Other +variables are IP4_ADDRESS_N where N is a number from 0 to (# IPv4 addresses \- 1), +in the format "address/prefix gateway". IP4_NUM_ADDRESSES contains the number +addresses the script may expect. IP4_NAMESERVERS contains a space-separated +list of the DNS servers, and IP4_DOMAINS contains a space-separated list of the +search domains. Routes use the format IP4_ROUTE_N where N is a number from 0 +to (# IPv4 routes \- 1), in the format "address/prefix next-hop metric", and +IP4_NUM_ROUTES contains the number of routes to expect. If the connection used +DHCP for address configuration, the received DHCP configuration is passed in the +environment using standard DHCP option names, prefixed with "DHCP4_", like +"DHCP4_HOST_NAME=foobar". +.TP +.I "down" +The interface has been deactivated. +.TP +.I "vpn\-up" +A VPN connection has been activated. The environment contains the connection +UUID in the variable CONNECTION_UUID. +.TP +.I "vpn\-down" +A VPN connection has been deactivated. +.TP +.I "hostname" +The system hostname has been updated. Use gethostname(2) to retrieve it. +.SH OPTIONS +The following options are supported: +.TP +.I "\-\-no\-daemon" +Do not daemonize. This is useful for debugging, and directs log output to the +controlling terminal in addition to syslog. +.TP +.I "\-\-pid\-file=<filename>" +Specify location of a PID file. The PID file is used for storing PID of the +running proccess and prevents running multiple instances. +.TP +.I "\-\-state\-file=<filename>" +Specify file for storing state of the NetworkManager persistently. If not specified, +the default value of '<LOCALSTATEDIR>/lib/NetworkManager/NetworkManager.state' is +used; where <LOCALSTATEDIR> is dependent on your distribution (usually it's /var). +.TP +.I "\-\-config=<filename>" +Specify configuration file to set up various settings for NetworkManager. If not +specified, the default value of '<SYSCONFDIR>/NetworkManager/NetworkManager.conf' +is used with a fallback to the older 'nm\-system\-settings.conf' if located in +the same directory; where <SYSCONFDIR> is dependent on your distribution (usually +it's /etc). See \fBNetworkManager.conf\fP(5) for more information on configuration +file. +.TP +.I "\-\-plugins=<plugin1>,<plugin2>, ... +List plugins used to manage system-wide connection settings. This list has +preference over plugins specified in the configuration file. Currently supported +plugins are: keyfile, ifcfg\-rh, ifcfg\-suse, ifupdown. +See \fBNetworkManager.conf\fP(5) for more information on the plugins. +.TP +.I "\-\-log\-level=<level> +Sets how much information NetworkManager sends to the log destination (usually +syslog's "daemon" facility). By default, only informational, warning, and error +messages are logged. See \fBNetworkManager.conf\fP(5) for more information on +log levels and domains. +.TP +.I "\-\-log\-domains=<domain1>,<domain2>, ... +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. +.SH DEBUGGING +The following environment variables are supported to help debugging. When used +in conjunction with the "\-\-no\-daemon" option (thus echoing PPP and DHCP helper +output to stdout) these can quickly help pinpoint the source of connection +issues. Also see the \-\-log\-level and \-\-log\-domains to enable debug logging inside +NetworkManager itself. +.TP +.I "NM_PPP_DEBUG" +When set to anything, causes NetworkManager to turn on PPP debugging in pppd, +which logs all PPP and PPTP frames and client/server exchanges. +.SH SEE ALSO +.BR nm\-tool (1), +.BR NetworkManager.conf (5). + diff --git a/man/NetworkManager.conf.5 b/man/NetworkManager.conf.5 new file mode 100644 index 00000000..c3af6116 --- /dev/null +++ b/man/NetworkManager.conf.5 @@ -0,0 +1,139 @@ +.\" NetworkManager.conf(5) manual page +.\" +.\" Copyright (C) 2010 Red Hat, Inc. +.\" +.TH "NetworkManager.conf" "5" "1 February 2010" "" +.SH NAME +NetworkManager.conf \- NetworkManager configuration file +.SH SYNOPSIS +/etc/NetworkManager/NetworkManager.conf +.br +or +.br +\fI<SYSCONFDIR>\fP/NetworkManager/NetworkManager.conf +.br +where <SYSCONFDIR> depends on your distribution or build. +.SH DESCRIPTION +.P +.I NetworkManager.conf +is a configuration file for NetworkManager. It is used to set up various +aspects of NetworkManager's behavior. The location of +the file may be changed through use of the "\-\-config=" argument for +\fBNetworkManager\fP (8). + +It is not necessary to restart NetworkManager when making changes, as the +configuration file is watched for changes and reloaded automatically when necessary. +.SH "FILE FORMAT" +.P +The configuration file format is so-called key file (sort of ini-style format). +It consists of sections (groups) of key-value pairs. Lines beginning with a '#' and blank +lines are considered comments. Sections are started by a header line containing +the section enclosed in '[' and ']', and ended implicitly by the start of +the next section or the end of the file. Each key-value pair must be contained +in a section. +.br +Minimal system settings configuration file looks like this: +.P +.nf +[main] +plugins=keyfile +.fi +.P +Description of sections and available keys follows: +.SS [main] +This section is the only mandatory section of the configuration file. +.TP +.B plugins=\fIplugin1\fP,\fIplugin2\fP, ... +List plugin names separated by ','. Plugins are used to read/write system-wide +connection. When more plugins are specified, the connections are read from all +listed plugins. When writing connections, the plugins will be asked to save the +connection in the order listed here. If the first plugin cannot write out that +connection type, or can't write out any connections, the next plugin is tried. +If none of the plugins can save the connection, the error is returned to the user. +.P +.RS +.B "Available plugins:" +.br +.TP +.I keyfile +plugin is the generic plugin that supports all the connection types and +capabilities that NetworkManager has. It writes files out in a .ini-style format in +/etc/NetworkManager/system-connections. For security, it will ignore files +that are readable or writeable by any user or group other than +.I root +since private keys and passphrases may be stored in plaintext inside the file. +.TP +.I ifcfg\-rh +plugin is used on the Fedora and Red Hat Enterprise Linux distributions +to read and write configuration from the standard /etc/sysconfig/network-scripts/ifcfg-* files. +It currently supports reading wired, WiFi, and 802.1x connections, but does not yet support reading +or writing mobile broadband, PPPoE, or VPN connections. To allow reading and writing of these +add \fIkeyfile\fP plugin to your configuration as well. +.TP +.I ifupdown +plugin is used on the Debian and Ubuntu distributions, and reads connections from +/etc/network/interfaces. Since it cannot write connections out (that support isn't planned), +it is usually paired with the \fIkeyfile\fP plugin to enable saving and editing of new connections. +The \fIifupdown\fP plugin supports basic wired and WiFi connections, including WPA-PSK. +.TP +.I ifcfg\-suse +plugin is only provided for simple backward compatibility with SUSE and OpenSUSE configuration. +Most setups should be using the \fIkeyfile\fP plugin instead. The \fIifcfg\-suse\fP plugin supports +reading wired and WiFi connections, but does not support saving any connection types. +.RE +.TP +.B dhcp=\fIdhclient\fP | \fIdhcpcd\fP +This key sets up what DHCP client NetworkManager will use. Presently +\fIdhclient\fP and \fIdhcpcd\fP are supported. The client configured here should +be available on your system too. If this key is missing, available DHCP clients +are looked for in this order: dhclient, dhcpcd. +.SS [keyfile] +This section contains keyfile-specific options and thus only has effect when using \fIkeyfile\fP plugin. +.TP +.B hostname=\fI<hostname>\fP +Set a persistent hostname when using the \fIkeyfile\fP plugin. +.TP +.B unmanaged-devices=\fImac:<hwaddr>\fP;\fImac:<hwaddr>\fP;... +Set devices that should be ignored by NetworkManager when using the \fIkeyfile\fP +plugin. Devices are specified in the following format: "mac:<hwaddr>", where +<hwaddr> is MAC address of the device to be ignored, in lowercase. Multiple +entries are separated by a semicolon. Example: +.nf +unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1e:65:30:d1:c4 +.fi +.SS [ifupdown] +This section contains ifupdown-specific options and thus only has effect when using \fIifupdown\fP plugin. +.TP +.B managed=\fIfalse\fP | \fItrue\fP +Controls whether interfaces listed in the 'interfaces' file are managed by NetworkManager. +If set to \fItrue\fP, then interfaces listed in /etc/network/interfaces are managed by NetworkManager. +If set to \fIfalse\fP, then any interface listed in /etc/network/interfaces will be +ignored by NetworkManager. Remember that NetworkManager controls the default route, +so because the interface is ignored, NetworkManager may assign the default route to +some other interface. +When the option is missing, \fIfalse\fP value is taken as default. +.SS [logging] +This section controls NetworkManager's logging. Any settings here are +overridden by the \-\-log\-level and \-\-log\-domains command-line options. +.TP +.B level=\fI<level>\fP +One of [ERR, WARN, INFO, DEBUG]. The ERR level logs only critical errors. WARN +logs warnings that may reflect operation. INFO logs various informational +messages that are useful for tracking state and operations. DEBUG enables +verbose logging for debugging purposes. Subsequent levels also log all messages +from earlier levels; thus setting the log level to INFO also logs error and +warning messages. +.TP +.B domains=\fI<domain1>,<domain2>, ...\fP +The following log domains are available: [NONE, HW, RKILL, ETHER, WIFI, BT, MB, +DHCP4, DHCP6, PPP, WIFI_SCAN, IP4, IP6, AUTOIP4, DNS, VPN, SHARING, SUPPLICANT, +USER_SET, SYS_SET, SUSPEND, CORE, DEVICE, OLPC]. When "NONE" is given by itself, +logging is disabled. MB = Mobile Broadband, USER_SET = user settings operations +and communication, SYS_SET = system settings service operations, OLPC = OLPC +Mesh device operations, CORE = core daemon operations, DEVICE = activation and +general interface operations. +.SH "SEE ALSO" +.BR http://live.gnome.org/NetworkManager/SystemSettings +.sp +.BR NetworkManager (8), +.BR nm\-tool (1). diff --git a/man/NetworkManager.conf.5.in b/man/NetworkManager.conf.5.in new file mode 100644 index 00000000..c3af6116 --- /dev/null +++ b/man/NetworkManager.conf.5.in @@ -0,0 +1,139 @@ +.\" NetworkManager.conf(5) manual page +.\" +.\" Copyright (C) 2010 Red Hat, Inc. +.\" +.TH "NetworkManager.conf" "5" "1 February 2010" "" +.SH NAME +NetworkManager.conf \- NetworkManager configuration file +.SH SYNOPSIS +/etc/NetworkManager/NetworkManager.conf +.br +or +.br +\fI<SYSCONFDIR>\fP/NetworkManager/NetworkManager.conf +.br +where <SYSCONFDIR> depends on your distribution or build. +.SH DESCRIPTION +.P +.I NetworkManager.conf +is a configuration file for NetworkManager. It is used to set up various +aspects of NetworkManager's behavior. The location of +the file may be changed through use of the "\-\-config=" argument for +\fBNetworkManager\fP (8). + +It is not necessary to restart NetworkManager when making changes, as the +configuration file is watched for changes and reloaded automatically when necessary. +.SH "FILE FORMAT" +.P +The configuration file format is so-called key file (sort of ini-style format). +It consists of sections (groups) of key-value pairs. Lines beginning with a '#' and blank +lines are considered comments. Sections are started by a header line containing +the section enclosed in '[' and ']', and ended implicitly by the start of +the next section or the end of the file. Each key-value pair must be contained +in a section. +.br +Minimal system settings configuration file looks like this: +.P +.nf +[main] +plugins=keyfile +.fi +.P +Description of sections and available keys follows: +.SS [main] +This section is the only mandatory section of the configuration file. +.TP +.B plugins=\fIplugin1\fP,\fIplugin2\fP, ... +List plugin names separated by ','. Plugins are used to read/write system-wide +connection. When more plugins are specified, the connections are read from all +listed plugins. When writing connections, the plugins will be asked to save the +connection in the order listed here. If the first plugin cannot write out that +connection type, or can't write out any connections, the next plugin is tried. +If none of the plugins can save the connection, the error is returned to the user. +.P +.RS +.B "Available plugins:" +.br +.TP +.I keyfile +plugin is the generic plugin that supports all the connection types and +capabilities that NetworkManager has. It writes files out in a .ini-style format in +/etc/NetworkManager/system-connections. For security, it will ignore files +that are readable or writeable by any user or group other than +.I root +since private keys and passphrases may be stored in plaintext inside the file. +.TP +.I ifcfg\-rh +plugin is used on the Fedora and Red Hat Enterprise Linux distributions +to read and write configuration from the standard /etc/sysconfig/network-scripts/ifcfg-* files. +It currently supports reading wired, WiFi, and 802.1x connections, but does not yet support reading +or writing mobile broadband, PPPoE, or VPN connections. To allow reading and writing of these +add \fIkeyfile\fP plugin to your configuration as well. +.TP +.I ifupdown +plugin is used on the Debian and Ubuntu distributions, and reads connections from +/etc/network/interfaces. Since it cannot write connections out (that support isn't planned), +it is usually paired with the \fIkeyfile\fP plugin to enable saving and editing of new connections. +The \fIifupdown\fP plugin supports basic wired and WiFi connections, including WPA-PSK. +.TP +.I ifcfg\-suse +plugin is only provided for simple backward compatibility with SUSE and OpenSUSE configuration. +Most setups should be using the \fIkeyfile\fP plugin instead. The \fIifcfg\-suse\fP plugin supports +reading wired and WiFi connections, but does not support saving any connection types. +.RE +.TP +.B dhcp=\fIdhclient\fP | \fIdhcpcd\fP +This key sets up what DHCP client NetworkManager will use. Presently +\fIdhclient\fP and \fIdhcpcd\fP are supported. The client configured here should +be available on your system too. If this key is missing, available DHCP clients +are looked for in this order: dhclient, dhcpcd. +.SS [keyfile] +This section contains keyfile-specific options and thus only has effect when using \fIkeyfile\fP plugin. +.TP +.B hostname=\fI<hostname>\fP +Set a persistent hostname when using the \fIkeyfile\fP plugin. +.TP +.B unmanaged-devices=\fImac:<hwaddr>\fP;\fImac:<hwaddr>\fP;... +Set devices that should be ignored by NetworkManager when using the \fIkeyfile\fP +plugin. Devices are specified in the following format: "mac:<hwaddr>", where +<hwaddr> is MAC address of the device to be ignored, in lowercase. Multiple +entries are separated by a semicolon. Example: +.nf +unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1e:65:30:d1:c4 +.fi +.SS [ifupdown] +This section contains ifupdown-specific options and thus only has effect when using \fIifupdown\fP plugin. +.TP +.B managed=\fIfalse\fP | \fItrue\fP +Controls whether interfaces listed in the 'interfaces' file are managed by NetworkManager. +If set to \fItrue\fP, then interfaces listed in /etc/network/interfaces are managed by NetworkManager. +If set to \fIfalse\fP, then any interface listed in /etc/network/interfaces will be +ignored by NetworkManager. Remember that NetworkManager controls the default route, +so because the interface is ignored, NetworkManager may assign the default route to +some other interface. +When the option is missing, \fIfalse\fP value is taken as default. +.SS [logging] +This section controls NetworkManager's logging. Any settings here are +overridden by the \-\-log\-level and \-\-log\-domains command-line options. +.TP +.B level=\fI<level>\fP +One of [ERR, WARN, INFO, DEBUG]. The ERR level logs only critical errors. WARN +logs warnings that may reflect operation. INFO logs various informational +messages that are useful for tracking state and operations. DEBUG enables +verbose logging for debugging purposes. Subsequent levels also log all messages +from earlier levels; thus setting the log level to INFO also logs error and +warning messages. +.TP +.B domains=\fI<domain1>,<domain2>, ...\fP +The following log domains are available: [NONE, HW, RKILL, ETHER, WIFI, BT, MB, +DHCP4, DHCP6, PPP, WIFI_SCAN, IP4, IP6, AUTOIP4, DNS, VPN, SHARING, SUPPLICANT, +USER_SET, SYS_SET, SUSPEND, CORE, DEVICE, OLPC]. When "NONE" is given by itself, +logging is disabled. MB = Mobile Broadband, USER_SET = user settings operations +and communication, SYS_SET = system settings service operations, OLPC = OLPC +Mesh device operations, CORE = core daemon operations, DEVICE = activation and +general interface operations. +.SH "SEE ALSO" +.BR http://live.gnome.org/NetworkManager/SystemSettings +.sp +.BR NetworkManager (8), +.BR nm\-tool (1). diff --git a/man/nm-system-settings.conf.5 b/man/nm-system-settings.conf.5 new file mode 100644 index 00000000..e48d0c8e --- /dev/null +++ b/man/nm-system-settings.conf.5 @@ -0,0 +1,26 @@ +.\" nm-system-settings.conf(5) manual page +.\" +.\" Copyright (C) 2010 Red Hat, Inc. +.\" +.TH "nm-system-settings.conf" "5" "1 February 2010" "" +.SH NAME +nm\-system\-settings.conf \- Deprecated NetworkManager configuration file +.SH SYNOPSIS +/etc/NetworkManager/nm\-system\-settings.conf +.br +or +.br +\fI<SYSCONFDIR>\fP/NetworkManager/nm\-system\-settings.conf +.br +where <SYSCONFDIR> depends on your distribution or build. +.SH DESCRIPTION +.P +.I nm\-system\-settings.conf +is a deprecated configuration file for \fBNetworkManager\fP (5). While this +file can still be used, NetworkManager now defaults to reading the config +file <SYSCONFDIR>\fP/NetworkManager/NetworkManager.conf\fP instead, falling back +to nm\-system\-settings.conf if NetworkManager.conf does not exist. +.SH "SEE ALSO" +.BR NetworkManager (8), +.BR NetworkManager.conf (5), +.BR nm\-tool (1). diff --git a/man/nm-system-settings.conf.5.in b/man/nm-system-settings.conf.5.in new file mode 100644 index 00000000..e48d0c8e --- /dev/null +++ b/man/nm-system-settings.conf.5.in @@ -0,0 +1,26 @@ +.\" nm-system-settings.conf(5) manual page +.\" +.\" Copyright (C) 2010 Red Hat, Inc. +.\" +.TH "nm-system-settings.conf" "5" "1 February 2010" "" +.SH NAME +nm\-system\-settings.conf \- Deprecated NetworkManager configuration file +.SH SYNOPSIS +/etc/NetworkManager/nm\-system\-settings.conf +.br +or +.br +\fI<SYSCONFDIR>\fP/NetworkManager/nm\-system\-settings.conf +.br +where <SYSCONFDIR> depends on your distribution or build. +.SH DESCRIPTION +.P +.I nm\-system\-settings.conf +is a deprecated configuration file for \fBNetworkManager\fP (5). While this +file can still be used, NetworkManager now defaults to reading the config +file <SYSCONFDIR>\fP/NetworkManager/NetworkManager.conf\fP instead, falling back +to nm\-system\-settings.conf if NetworkManager.conf does not exist. +.SH "SEE ALSO" +.BR NetworkManager (8), +.BR NetworkManager.conf (5), +.BR nm\-tool (1). diff --git a/man/nm-tool.1 b/man/nm-tool.1 new file mode 100644 index 00000000..168a5dc5 --- /dev/null +++ b/man/nm-tool.1 @@ -0,0 +1,17 @@ +.\" nm-tool(1) manual page +.\" +.\" Copyright (C) 2005 - 2009 Red Hat, Inc. +.\" Copyright (C) 2005 - 2009 Novell, Inc. +.\" Copyright (C) 2005 Robert Love +.\" +.TH NM-TOOL "1" +.SH NAME +nm-tool \- utility to report NetworkManager state and devices +.SH SYNOPSIS +.B nm-tool +.SH DESCRIPTION +The \fInm-tool\fP utility provides information about NetworkManager, device, +and wireless networks. +.SH SEE ALSO +.BR NetworkManager (8), + diff --git a/man/nm-tool.1.in b/man/nm-tool.1.in new file mode 100644 index 00000000..168a5dc5 --- /dev/null +++ b/man/nm-tool.1.in @@ -0,0 +1,17 @@ +.\" nm-tool(1) manual page +.\" +.\" Copyright (C) 2005 - 2009 Red Hat, Inc. +.\" Copyright (C) 2005 - 2009 Novell, Inc. +.\" Copyright (C) 2005 Robert Love +.\" +.TH NM-TOOL "1" +.SH NAME +nm-tool \- utility to report NetworkManager state and devices +.SH SYNOPSIS +.B nm-tool +.SH DESCRIPTION +The \fInm-tool\fP utility provides information about NetworkManager, device, +and wireless networks. +.SH SEE ALSO +.BR NetworkManager (8), + diff --git a/man/nmcli.1 b/man/nmcli.1 new file mode 100644 index 00000000..056b5bdd --- /dev/null +++ b/man/nmcli.1 @@ -0,0 +1,321 @@ +.\" nmcli (1) manual page +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, +.\" USA. +.\" +.\" Copyright (C) 2010 Red Hat, Inc. +.\" +.TH NMCLI "1" "14 April 2010" + +.SH NAME +nmcli \- command-line tool for controlling NetworkManager +.SH SYNOPSIS +.ad l +.B nmcli +.RI " [ " OPTIONS " ] " OBJECT " { " COMMAND " | " +.BR help " } " +.sp + +.IR OBJECT " := { " +.BR nm " | " con " | " dev " } " +.sp + +.IR OPTIONS " := { " +.br +\fB\-t\fR[\fIerse\fR] +.br +\fB\-p\fR[\fIretty\fR] +.br +\fB\-m\fR[\fImode\fR] tabular | multiline +.br +\fB\-f\fR[\fIields\fR] <field1,field2,...> | all | common +.br +\fB\-e\fR[\fIscape\fR] yes | no +.br +\fB\-v\fR[\fIersion\fR] +.br +\fB\-h\fR[\fIelp\fR] +.br +.RI "}" + +.SH DESCRIPTION +.B nmcli +is a command-line tool for controlling NetworkManager and getting its status. +It is not meant as a replacement of \fInm-applet\fP or other similar clients. +Rather it's a complementary utility to these programs. +The main \fInmcli\fP's usage is on servers, headless machines or just for +power users who prefer the command line. +.P +The use cases comprise: +.IP \(em 4 +Initscripts: ifup/ifdown can utilize NetworkManager via \fInmcli\fP instead of +having to manage connections itself and possible interfere with NetworkManager. +.IP \(em 4 +Servers, headless machines: No GUI is available; then \fInmcli\fP is used to +talk directly to NetworkManager and control only system-wide connections. +.IP \(em 4 +User sessions: For this case, \fInmcli\fP can talk to \fInm-applet\fP to find +user connections. It can still talk directly to NetworkManager for manipulating +these connections. As \fInmcli\fP doesn't have direct access to user +configuration data in GConf, \fInm-applet\fP handles that itself. That may, +for example, cause the applet to pop up keyring dialogs when secrets are needed. +.SS \fIOPTIONS\fP +.TP +.B \-t, \-\-terse +Output is terse. This mode is designed and suitable for computer (script) +processing. +.TP +.B \-p, \-\-pretty +Output is pretty. This causes \fInmcli\fP to produce easy readable outputs +for humans, i.e. values are aligned, headers are printed, etc. +.TP +.B \-m, \-\-mode tabular | multiline +Switch between \fItabular\fP and \fImultiline\fP output. +If omitted, default is \fItabular\fP for most commands. For the commands +producing more structured information, that cannot be displayed on a single +line, default is \fImultiline\fP. Currenly, they are: +.br +.nf + 'nmcli con list id|uuid <name>' + 'nmcli dev list' +.fi +\fItabular\fP - Output is a table where each line describes a single entry. +Columns define particular properties of the entry. +.br +\fImultiline\fP - Each entry comprises more lines, each property on its own line. +The values are prefixed with the property name. +.TP +.B \-f, \-\-fields <field1,field2,...> | all | common +This option is used to specify what fields (column names) should be printed. +Valid field names differ for specific commands. List available fields by +providing an invalid value to the \fI--fields\fP option. +.br +\fIall\fP is used to print all valid field values of the command. +\fIcommon\fP is used to print common field values of the command. +If omitted, default is \fIcommon\fP. +The option is mandatory when \fI--terse\fP is used. In this case, generic +values \fIall\fP and \fIcommon\fP cannot be used. (This is to maintain +compatibility when new fields are added in the future). +.TP +.B \-e, \-\-escape yes | no +Whether to escape ':' and '\\' characters in terse tabular mode. The escape +character is '\\'. +If omitted, default is \fIyes\fP. +.TP +.B \-v, \-\-version +Show \fInmcli\fP version. +.TP +.B \-h, \-\-help +Print help information. +.SS \fIOBJECT\fP +.TP +.B nm +NetworkManager +.br +Use this object to inquire and change state of NetworkManager. +.TP +.SS \fICOMMAND\fP := { status | sleep | wakeup | wifi | wwan } +.sp +.RS +.TP +.B status +.br +Show overall status of NetworkManager. This is the default action, when no +command is provided to \fInm\fP object. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B sleep +.br +Put NetworkManager to sleeping mode. Thus all interfaces that NetworkManager +manages are deactivated. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: Sleep +arguments: TRUE +.fi +.TP +.B wakeup +.br +Awake NetworkManager from sleep. When NetworkManager is awaken, devices are +available to be activated. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: Sleep +arguments: FALSE +.fi +.TP +.B wifi [on|off] +.br +Inquire or set status of WiFi in NetworkManager. Without any further argument, +WiFi status is printed; \fIon\fP enables WiFi; \fIoff\fP disables WiFi. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B wwan [on|off] +.br +Inquire or set status of WWAN in NetworkManager. Without any further argument, +WWAN status is printed; \fIon\fP enables WWAN; \fIoff\fP disables WWAN. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.RE + +.TP +.B con +Connections +.br +Get information about NetworkManager's connections. +.TP +.SS \fICOMMAND\fP := { list | status | up | down } +.sp +.RS +.TP +.B list [id <id> | uuid <id> | system | user] +.br +List configured connections. Without a parameter, configured connection from +both system and user settings services are listed. \fIsystem\fP argument filters +only system-wide connections, \fIuser\fP prints user connections only. +In order to get connection details, \fIid\fP with connection's name or \fIuuid\fP +with connection's UUID shall be specified. +When no command is given to \fIcon\fP object, the default action is 'nmcli con list'. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B status +.br +Print status of active connections. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B up id <id> | uuid <id> [iface <iface>] [ap <hwaddr>] [\-\-nowait] [\-\-timeout <timeout>] +.br +Activate a connection. The connection is identified by its name using \fIid\fP +or UUID using \fIuuid\fP. For requiring particular device to activate +the connection on, \fIiface\fP option with interface name should be given. +\fIap\fP option can further concretize what AP should be used in case of WiFi +connection. \fI\-\-nowait\fP option causes \fInmcli\fP to exit immediately and +not to wait for command completion. \fI\-\-timeout\fP option provides a means +to specify how long to wait for operation completion. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: ActivateConnection +arguments: according to arguments +.fi +.TP +.B down id <id> | uuid <id> +.br +Deactivate a connection. +The connection is identified by its name using \fIid\fP +or UUID using \fIuuid\fP. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: DeactivateConnection +arguments: according to arguments +.fi +.RE + +.TP +.B dev +Devices +.br +Get information about devices. +.TP +.SS \fICOMMAND\fP := { status | list | disconnect | wifi } +.sp +.RS +.TP +.B status +.br +Print status of devices. This is the default action, when no command +is specified to \fIdev\fP object. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B list [iface <iface>] +.br +Get detailed information about devices. Without an argument, all devices are +examined. To get information for a specific device, \fIiface\fP argument +with the interface name should be provided. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B disconnect iface <iface> [\-\-nowait] [\-\-timeout <timeout>] +.br +Disconnect a device and prevent the device from automatically activating further +connections without user/manual intervention. \fI\-\-nowait\fP option causes +\fInmcli\fP to exit immediately and not to wait for command completion. +\fI\-\-timeout\fP option provides a means to specify how long to wait for +operation completion. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager.Device +method: Disconnect +arguments: none +.fi +.TP +.B wifi [list [iface <iface>] [hwaddr <hwaddr>]] +.br +List available WiFi access points. \fIiface\fP and \fIhwaddr\fP options +can be used to get just APs for particular interface or specific AP, +respectively. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.RE + +.SH BUGS +There are probably some. If you find a bug, please report to +https://bugzilla.gnome.org/ \- product \fINetworkManager\fP. + +.SH SEE ALSO +.BR nm\-tool (1), +.BR NetworkManager(8). diff --git a/man/nmcli.1.in b/man/nmcli.1.in new file mode 100644 index 00000000..056b5bdd --- /dev/null +++ b/man/nmcli.1.in @@ -0,0 +1,321 @@ +.\" nmcli (1) manual page +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, +.\" USA. +.\" +.\" Copyright (C) 2010 Red Hat, Inc. +.\" +.TH NMCLI "1" "14 April 2010" + +.SH NAME +nmcli \- command-line tool for controlling NetworkManager +.SH SYNOPSIS +.ad l +.B nmcli +.RI " [ " OPTIONS " ] " OBJECT " { " COMMAND " | " +.BR help " } " +.sp + +.IR OBJECT " := { " +.BR nm " | " con " | " dev " } " +.sp + +.IR OPTIONS " := { " +.br +\fB\-t\fR[\fIerse\fR] +.br +\fB\-p\fR[\fIretty\fR] +.br +\fB\-m\fR[\fImode\fR] tabular | multiline +.br +\fB\-f\fR[\fIields\fR] <field1,field2,...> | all | common +.br +\fB\-e\fR[\fIscape\fR] yes | no +.br +\fB\-v\fR[\fIersion\fR] +.br +\fB\-h\fR[\fIelp\fR] +.br +.RI "}" + +.SH DESCRIPTION +.B nmcli +is a command-line tool for controlling NetworkManager and getting its status. +It is not meant as a replacement of \fInm-applet\fP or other similar clients. +Rather it's a complementary utility to these programs. +The main \fInmcli\fP's usage is on servers, headless machines or just for +power users who prefer the command line. +.P +The use cases comprise: +.IP \(em 4 +Initscripts: ifup/ifdown can utilize NetworkManager via \fInmcli\fP instead of +having to manage connections itself and possible interfere with NetworkManager. +.IP \(em 4 +Servers, headless machines: No GUI is available; then \fInmcli\fP is used to +talk directly to NetworkManager and control only system-wide connections. +.IP \(em 4 +User sessions: For this case, \fInmcli\fP can talk to \fInm-applet\fP to find +user connections. It can still talk directly to NetworkManager for manipulating +these connections. As \fInmcli\fP doesn't have direct access to user +configuration data in GConf, \fInm-applet\fP handles that itself. That may, +for example, cause the applet to pop up keyring dialogs when secrets are needed. +.SS \fIOPTIONS\fP +.TP +.B \-t, \-\-terse +Output is terse. This mode is designed and suitable for computer (script) +processing. +.TP +.B \-p, \-\-pretty +Output is pretty. This causes \fInmcli\fP to produce easy readable outputs +for humans, i.e. values are aligned, headers are printed, etc. +.TP +.B \-m, \-\-mode tabular | multiline +Switch between \fItabular\fP and \fImultiline\fP output. +If omitted, default is \fItabular\fP for most commands. For the commands +producing more structured information, that cannot be displayed on a single +line, default is \fImultiline\fP. Currenly, they are: +.br +.nf + 'nmcli con list id|uuid <name>' + 'nmcli dev list' +.fi +\fItabular\fP - Output is a table where each line describes a single entry. +Columns define particular properties of the entry. +.br +\fImultiline\fP - Each entry comprises more lines, each property on its own line. +The values are prefixed with the property name. +.TP +.B \-f, \-\-fields <field1,field2,...> | all | common +This option is used to specify what fields (column names) should be printed. +Valid field names differ for specific commands. List available fields by +providing an invalid value to the \fI--fields\fP option. +.br +\fIall\fP is used to print all valid field values of the command. +\fIcommon\fP is used to print common field values of the command. +If omitted, default is \fIcommon\fP. +The option is mandatory when \fI--terse\fP is used. In this case, generic +values \fIall\fP and \fIcommon\fP cannot be used. (This is to maintain +compatibility when new fields are added in the future). +.TP +.B \-e, \-\-escape yes | no +Whether to escape ':' and '\\' characters in terse tabular mode. The escape +character is '\\'. +If omitted, default is \fIyes\fP. +.TP +.B \-v, \-\-version +Show \fInmcli\fP version. +.TP +.B \-h, \-\-help +Print help information. +.SS \fIOBJECT\fP +.TP +.B nm +NetworkManager +.br +Use this object to inquire and change state of NetworkManager. +.TP +.SS \fICOMMAND\fP := { status | sleep | wakeup | wifi | wwan } +.sp +.RS +.TP +.B status +.br +Show overall status of NetworkManager. This is the default action, when no +command is provided to \fInm\fP object. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B sleep +.br +Put NetworkManager to sleeping mode. Thus all interfaces that NetworkManager +manages are deactivated. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: Sleep +arguments: TRUE +.fi +.TP +.B wakeup +.br +Awake NetworkManager from sleep. When NetworkManager is awaken, devices are +available to be activated. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: Sleep +arguments: FALSE +.fi +.TP +.B wifi [on|off] +.br +Inquire or set status of WiFi in NetworkManager. Without any further argument, +WiFi status is printed; \fIon\fP enables WiFi; \fIoff\fP disables WiFi. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B wwan [on|off] +.br +Inquire or set status of WWAN in NetworkManager. Without any further argument, +WWAN status is printed; \fIon\fP enables WWAN; \fIoff\fP disables WWAN. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.RE + +.TP +.B con +Connections +.br +Get information about NetworkManager's connections. +.TP +.SS \fICOMMAND\fP := { list | status | up | down } +.sp +.RS +.TP +.B list [id <id> | uuid <id> | system | user] +.br +List configured connections. Without a parameter, configured connection from +both system and user settings services are listed. \fIsystem\fP argument filters +only system-wide connections, \fIuser\fP prints user connections only. +In order to get connection details, \fIid\fP with connection's name or \fIuuid\fP +with connection's UUID shall be specified. +When no command is given to \fIcon\fP object, the default action is 'nmcli con list'. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B status +.br +Print status of active connections. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B up id <id> | uuid <id> [iface <iface>] [ap <hwaddr>] [\-\-nowait] [\-\-timeout <timeout>] +.br +Activate a connection. The connection is identified by its name using \fIid\fP +or UUID using \fIuuid\fP. For requiring particular device to activate +the connection on, \fIiface\fP option with interface name should be given. +\fIap\fP option can further concretize what AP should be used in case of WiFi +connection. \fI\-\-nowait\fP option causes \fInmcli\fP to exit immediately and +not to wait for command completion. \fI\-\-timeout\fP option provides a means +to specify how long to wait for operation completion. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: ActivateConnection +arguments: according to arguments +.fi +.TP +.B down id <id> | uuid <id> +.br +Deactivate a connection. +The connection is identified by its name using \fIid\fP +or UUID using \fIuuid\fP. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager +method: DeactivateConnection +arguments: according to arguments +.fi +.RE + +.TP +.B dev +Devices +.br +Get information about devices. +.TP +.SS \fICOMMAND\fP := { status | list | disconnect | wifi } +.sp +.RS +.TP +.B status +.br +Print status of devices. This is the default action, when no command +is specified to \fIdev\fP object. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B list [iface <iface>] +.br +Get detailed information about devices. Without an argument, all devices are +examined. To get information for a specific device, \fIiface\fP argument +with the interface name should be provided. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.TP +.B disconnect iface <iface> [\-\-nowait] [\-\-timeout <timeout>] +.br +Disconnect a device and prevent the device from automatically activating further +connections without user/manual intervention. \fI\-\-nowait\fP option causes +\fInmcli\fP to exit immediately and not to wait for command completion. +\fI\-\-timeout\fP option provides a means to specify how long to wait for +operation completion. +.br +.nf +\fBReference to D-Bus:\fP +interface: org.freedesktop.NetworkManager.Device +method: Disconnect +arguments: none +.fi +.TP +.B wifi [list [iface <iface>] [hwaddr <hwaddr>]] +.br +List available WiFi access points. \fIiface\fP and \fIhwaddr\fP options +can be used to get just APs for particular interface or specific AP, +respectively. +.br +.nf +\fBReference to D-Bus:\fP +No simple reference. +.fi +.RE + +.SH BUGS +There are probably some. If you find a bug, please report to +https://bugzilla.gnome.org/ \- product \fINetworkManager\fP. + +.SH SEE ALSO +.BR nm\-tool (1), +.BR NetworkManager(8). |