From: Roy Marples <roy@marples.name>
Date: Mon, 3 Jan 2011 11:41:40 +0000 (+0000)
Subject: Update documentation about --request.
X-Git-Tag: v5.2.11~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=006894bf46b84a00685c4c8adc8fb0ec10861a5e;p=thirdparty%2Fdhcpcd.git

Update documentation about --request.
---

diff --git a/dhcpcd.8.in b/dhcpcd.8.in
index 59938786..f97dcb39 100644
--- a/dhcpcd.8.in
+++ b/dhcpcd.8.in
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2006-2010 Roy Marples
+.\" Copyright (c) 2006-2011 Roy Marples
 .\" All rights reserved
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd August 31, 2010
+.Dd January 3, 2011
 .Dt DHCPCD 8 SMM
 .Os
 .Sh NAME
@@ -274,17 +274,10 @@ Sometimes, this isn't desirable if, for example, you have root mounted over
 NFS.
 You can use this option to stop this from happening.
 .It Fl r , -request Op Ar address
-.Nm
-normally sends a DHCP DISCOVER to find servers to offer an address.
-.Nm
-then requests the address used.
-You can use this option to skip the DISCOVER phase and just request the
-.Ar address .
-The downside is if you request an
+Request the
 .Ar address
-the DHCP server does not know about or the DHCP server is not
-authoritative, it will remain silent.
-In this situation, we go back to the init state and DISCOVER again.
+in the DHCP DISCOVER message.
+There is no guarantee this is the address the DHCP server will actual give.
 If no
 .Ar address
 is given then the first address currently assigned to the
@@ -293,7 +286,7 @@ is used.
 .It Fl s , -inform Op Ar address Ns Op Ar /cidr
 Behaves like
 .Fl r , -request
-as above, but sends a DHCP INFORM instead of a REQUEST.
+as above, but sends a DHCP INFORM instead of DISCOVER/REQUEST.
 This does not get a lease as such, just notifies the DHCP server of the
 .Ar address
 in use.