Bug 138206

Summary: [patch] ntp(1): not enabled function, and false manual
Product: Documentation Reporter: Oliver Pinter <oliver.pntr>
Component: Books & ArticlesAssignee: Benedict Reuschling <bcr>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.txt none

Description Oliver Pinter 2009-08-26 15:20:02 UTC
    man:
    
         -d      Specify debugging mode.  This option may occur more than once,
                 with each occurrence indicating greater detail of display.
    
    shell:
    
    /etc# ntpd -d -c /etc/ntp.conf
    ntpd: illegal option -- d
    ntpd - NTP daemon program - Ver. 4.2.4p5
    USAGE:  ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]...

------------

after the attached patch:

 # ntpd -dddddddd
 ntpd 4.2.4p5-a Tue Aug 25 16:18:59 CEST 2009 (1)
 adding new filegen
 adding new filegen
 adding new filegen
 adding new filegen
 adding new filegen
 adding new filegen
 addto_syslog: set_process_priority: Leave priority alone: priority_done is <2>
 addto_syslog: precision = 0.698 usec
 create_sockets(123)
 addto_syslog: ntp_io: estimated max descriptors: 11095, initial socket boundary:
  20
 addto_syslog: bind() fd 20, family 2, port 123, addr 0.0.0.0, in_classd=0 flags=
 0x89 fails: Address already in use
 addto_syslog: unable to bind to wildcard socket address 0.0.0.0 - another proces
 s may be running - EXITIN

---

this output is OK

Fix: Patch attached with submission follows:
How-To-Repeat: ntp[qd] -d foo
Comment 1 Mark Linimon freebsd_committer freebsd_triage 2009-08-26 15:26:15 UTC
Responsible Changed
From-To: freebsd-bugs->freebsd-doc

Fix synopsis.
Comment 2 dfilter service freebsd_committer freebsd_triage 2010-05-18 19:14:25 UTC
Author: bcr (doc committer)
Date: Tue May 18 18:14:12 2010
New Revision: 208273
URL: http://svn.freebsd.org/changeset/base/208273

Log:
  Add a sentence to the man page explaining that the -d option
  can only be used when ntpd is compiled with DEBUG support.
  
  PR:             docs/138206
  Submitted by:   Oliver Pinter (oliver dot pntr at gmail dot com)
  MFC after:      5 days
  Approved by:    roberto

Modified:
  head/usr.sbin/ntp/doc/ntpd.8

Modified: head/usr.sbin/ntp/doc/ntpd.8
==============================================================================
--- head/usr.sbin/ntp/doc/ntpd.8	Tue May 18 17:43:53 2010	(r208272)
+++ head/usr.sbin/ntp/doc/ntpd.8	Tue May 18 18:14:12 2010	(r208273)
@@ -1,7 +1,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 17, 2006
+.Dd May 18, 2010
 .Dt NTPD 8
 .Os
 .Sh NAME
@@ -108,6 +108,9 @@ Specify the name and path of the configu
 Specify debugging mode.
 This option may occur more than once,
 with each occurrence indicating greater detail of display.
+You need to compile
+.Nm
+with DEBUG in order to use this.
 .It Fl D Ar level
 Specify debugging level directly.
 .It Fl f Ar driftfile
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 3 Benedict Reuschling freebsd_committer freebsd_triage 2010-05-18 19:15:34 UTC
State Changed
From-To: open->patched

Fixed in r208273, MFC pending. 


Comment 4 Benedict Reuschling freebsd_committer freebsd_triage 2010-05-18 19:15:34 UTC
Responsible Changed
From-To: freebsd-doc->bcr

Fixed in r208273, MFC pending.
Comment 5 dfilter service freebsd_committer freebsd_triage 2010-05-23 12:27:03 UTC
Author: bcr (doc committer)
Date: Sun May 23 11:26:43 2010
New Revision: 208446
URL: http://svn.freebsd.org/changeset/base/208446

Log:
  MFC r208273:
  Add a sentence to the man page explaining that the -d option
  can only be used when ntpd is compiled with DEBUG support.
  
  PR:             docs/138206
  Submitted by:   Oliver Pinter (oliver dot pntr at gmail dot com)
  Approved by:    roberto

Modified:
  stable/8/usr.sbin/ntp/doc/ntpd.8

Modified: stable/8/usr.sbin/ntp/doc/ntpd.8
==============================================================================
--- stable/8/usr.sbin/ntp/doc/ntpd.8	Sun May 23 11:20:26 2010	(r208445)
+++ stable/8/usr.sbin/ntp/doc/ntpd.8	Sun May 23 11:26:43 2010	(r208446)
@@ -1,7 +1,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 17, 2006
+.Dd May 18, 2010
 .Dt NTPD 8
 .Os
 .Sh NAME
@@ -108,6 +108,9 @@ Specify the name and path of the configu
 Specify debugging mode.
 This option may occur more than once,
 with each occurrence indicating greater detail of display.
+You need to compile
+.Nm
+with DEBUG in order to use this.
 .It Fl D Ar level
 Specify debugging level directly.
 .It Fl f Ar driftfile
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 6 dfilter service freebsd_committer freebsd_triage 2010-05-23 12:28:24 UTC
Author: bcr (doc committer)
Date: Sun May 23 11:28:04 2010
New Revision: 208447
URL: http://svn.freebsd.org/changeset/base/208447

Log:
  MFC r208273:
  Add a sentence to the man page explaining that the -d option
  can only be used when ntpd is compiled with DEBUG support.
  
  PR:             docs/138206
  Submitted by:   Oliver Pinter (oliver dot pntr at gmail dot com)
  Approved by:    roberto

Modified:
  stable/7/usr.sbin/ntp/doc/ntpd.8

Modified: stable/7/usr.sbin/ntp/doc/ntpd.8
==============================================================================
--- stable/7/usr.sbin/ntp/doc/ntpd.8	Sun May 23 11:26:43 2010	(r208446)
+++ stable/7/usr.sbin/ntp/doc/ntpd.8	Sun May 23 11:28:04 2010	(r208447)
@@ -1,7 +1,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 17, 2006
+.Dd May 18, 2010
 .Dt NTPD 8
 .Os
 .Sh NAME
@@ -108,6 +108,9 @@ Specify the name and path of the configu
 Specify debugging mode.
 This option may occur more than once,
 with each occurrence indicating greater detail of display.
+You need to compile
+.Nm
+with DEBUG in order to use this.
 .It Fl D Ar level
 Specify debugging level directly.
 .It Fl f Ar driftfile
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 7 Benedict Reuschling freebsd_committer freebsd_triage 2010-05-23 12:35:57 UTC
State Changed
From-To: patched->closed

MFC done, PR closed. Thanks for sending it.