Bug 125185

Summary:	renice man page incorrect
Product:	[Fedora] Fedora	Reporter:	Stewart Wright <svwright+fedora>
Component:	util-linux	Assignee:	Elliot Lee <sopwith>
Status:	CLOSED WORKSFORME	QA Contact:	Ben Levenson <benl>
Severity:	high	Docs Contact:
Priority:	medium
Version:	2	CC:	twaugh
Target Milestone:	---	Keywords:	EasyFix
Target Release:	---
Hardware:	i686
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2004-12-10 15:47:41 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Stewart Wright 2004-06-03 14:39:34 UTC

Description of problem:
  Renice does not seem to allow the changing of process priorities.
  Renice fails with a "setpriority: Operation not permitted" error.

Version-Release number of selected component (if applicable):
  FC2

How reproducible:
  Always

Steps to Reproduce:
1. Find a already running process' PID (i.e. mozilla)
2. renice -n 10 -p PID
  
Actual results:
  > renice -n 10 -p 8537
  renice: 10: setpriority: Operation not permitted
  8537: old priority 0, new priority 0
  

Expected results:
  A reniced process!  ;-)

Additional info:
  There is an additional problem with setpriority(2) which I will
report as a bug too.

Comment 1 Tim Waugh 2004-06-03 14:46:54 UTC

Use: renice 10 -p ...

Man page is wrong, but 'renice --help' output is correct.

Comment 2 Stewart Wright 2004-06-03 14:55:50 UTC

The change in syntax doesn't work...

> renice -10 -p 1156
renice: 1156: setpriority: Permission denied


I've submitted another bug (#125187) showing a failure of
setpriority(2).  I wonder if these are related.

As a side issue, 'top' also fails on "renice"ing.

Comment 3 Tim Waugh 2004-06-03 15:09:18 UTC

From the man page:

"Only the super-user may lower priorities."

Comment 4 Stewart Wright 2004-06-03 18:19:28 UTC

Oops.  Should have RTFM a bit closer.  Mea culpa.

Still there is the problem that renice won't allow an increase in
priority as described in the initial bug report.

Comment 5 Tim Waugh 2004-06-03 19:05:15 UTC

renice is functioning correctly for me.

The problem is that the man page is incorrect.

Comment 6 Elliot Lee 2004-12-10 15:47:41 UTC

The renice man page doesn't mention a -n option, so everything looks
correct except the command line that was used.

Comment 7 Robin Green 2005-06-23 16:05:08 UTC

I have identified the real problem here and filed it as bug 161462.