Bug 124469

Summary:	incomplete nice(1) manpage
Product:	Documentation	Reporter:	Ighighi <ighighi>
Component:	Books & Articles	Assignee:	Remko Lodder <remko>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Ighighi 2008-06-11 10:30:01 UTC

There's no mention of the range of available nice values...  Not even
a pointer to the nice(3) manpage to supplement it.

Fix: 

I suggest adding this sentence present in NetBSD's nice(1):

"The priority can be adjusted over a range of -20 (the highest) to
20 (the lowest)."

See:
http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.bin/nice/nice.1

Also, a pointer to nice(3) would be ok.
We may also use renice(8) which is a lot more complete.

Comment 1 Remko Lodder freebsd_committer

2008-06-12 11:53:37 UTC

Responsible Changed
From-To: freebsd-doc->remko

I'll take it.

Comment 2 dfilter service freebsd_committer

2011-02-24 16:13:38 UTC

Author: remko
Date: Thu Feb 24 16:13:33 2011
New Revision: 219003
URL: http://svn.freebsd.org/changeset/base/219003

Log:
  Add wording about the priority range and
  mention what effect this has at certain
  values.
  
  PR:		124469
  Obtained from:	NetBSD nice.1 v1.14
  MFC after:	1 week

Modified:
  head/usr.bin/nice/nice.1

Modified: head/usr.bin/nice/nice.1
==============================================================================
--- head/usr.bin/nice/nice.1	Thu Feb 24 14:56:12 2011	(r219002)
+++ head/usr.bin/nice/nice.1	Thu Feb 24 16:13:33 2011	(r219003)
@@ -28,7 +28,7 @@
 .\"	@(#)nice.1	8.1 (Berkeley) 6/6/93
 .\" $FreeBSD$
 .\"
-.Dd June 6, 1993
+.Dd February 24, 2011
 .Dt NICE 1
 .Os
 .Sh NAME
@@ -50,6 +50,11 @@ value by the specified
 .Ar increment ,
 or a default value of 10.
 The lower the nice value of a process, the higher its scheduling priority.
+.Ar increment .
+The priority can be adjusted over a range of -20 (the higest) to 20 (the
+lowest).
+A priority of 19 or 20 will prevent a process from taking any cycles from
+others at nice 0 or better.
 .Pp
 The superuser may specify a negative increment in order to run a utility
 with a higher scheduling priority.
@@ -107,6 +112,7 @@ option has been deprecated but is still 
 .Xr rtprio 1 ,
 .Xr getpriority 2 ,
 .Xr setpriority 2 ,
+.Xr nice 3,
 .Xr renice 8
 .Sh STANDARDS
 The
_______________________________________________
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 Remko Lodder freebsd_committer

2011-02-24 16:21:37 UTC

State Changed
From-To: open->patched

This had been committed to -head

Comment 4 Remko Lodder freebsd_committer

2011-02-26 11:28:31 UTC

State Changed
From-To: patched->closed

This is not accurate and is thus reverted.