From 3a32e5c31ddd280a4e1fca3cb329b42eb5d617bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ji=C5=99=C3=AD=20Klime=C5=A1?= <jklimes@redhat.com>
Date: Fri, 6 Aug 2010 13:51:41 +0200
Subject: [PATCH] man: add a manpage for nm-online

---
 configure.ac       |  1 +
 man/Makefile.am    |  2 ++
 man/nm-online.1.in | 64 ++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 67 insertions(+)
 create mode 100644 man/nm-online.1.in

diff --git a/configure.ac b/configure.ac
index b1d16f252e..e1b93471a3 100644
--- a/configure.ac
+++ b/configure.ac
@@ -518,6 +518,7 @@ man/NetworkManager.8
 man/NetworkManager.conf.5
 man/nm-system-settings.conf.5
 man/nm-tool.1
+man/nm-online.1
 man/nmcli.1
 po/Makefile.in
 policy/Makefile
diff --git a/man/Makefile.am b/man/Makefile.am
index 097fdc6bea..973ef2c250 100644
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -3,6 +3,7 @@ man_MANS =				\
 	NetworkManager.conf.5		\
 	nm-system-settings.conf.5	\
 	nm-tool.1			\
+	nm-online.1			\
 	nmcli.1
 
 EXTRA_DIST =				\
@@ -11,6 +12,7 @@ EXTRA_DIST =				\
 	NetworkManager.conf.5.in	\
 	nm-system-settings.conf.5.in	\
 	nm-tool.1.in			\
+	nm-online.1.in			\
 	nmcli.1.in
 
 CLEANFILES = $(man_MANS)
diff --git a/man/nm-online.1.in b/man/nm-online.1.in
new file mode 100644
index 0000000000..2c8c9e9afc
--- /dev/null
+++ b/man/nm-online.1.in
@@ -0,0 +1,64 @@
+.\" nm-online (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 NM-ONLINE "1" "6 August 2010"
+
+.SH NAME
+nm-online \- ask NetworkManager whether the network is connected
+.SH SYNOPSIS
+.B nm-online
+.RI " [ " OPTIONS " ]
+
+.SH DESCRIPTION
+.B nm-online
+is a utility to find out whether we are online. It is done by asking
+NetworkManager about its status. When run, \fInm\-online\fP waits until
+NetworkManager reports an active connection, or specified timeout expires. On
+exit, the returned status code should be checked (see the return codes bellow).
+
+.SH OPTIONS
+.TP
+.B \-t, \-\-timeout
+Time to wait for a connection, in seconds.  If not specified, the default is 30
+seconds.
+.TP
+.B \-x, \-\-exit
+Exit immediately if NetworkManager is not running or connecting.
+.TP
+.B \-q, \-\-quiet
+Don't print anything.
+
+.SH EXIT STATUS
+
+.IP "0" 4
+Success - already online or connection established within given timeout
+.IP "1" 4
+Offline or not online within given timeout
+.IP "2" 4
+Unspecified error
+
+.SH SEE ALSO
+.BR nm\-tool (1),
+.BR nmcli (1),
+.BR NetworkManager(8).