Bug#691195: Bug#652443: ioprio_get(2): document who==0

2013-02-12 Thread Michael Kerrisk (man-pages)
Hi Jens,

Would you be able to comment on
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=691195 please? Either
in that bug, or to this mail?

Thanks,

Michael

On Mon, Oct 22, 2012 at 10:05 PM, Simon Paillard spaill...@debian.org wrote:
 Version: 3.42-1

 On Sun, Jul 29, 2012 at 08:32:49AM +0200, Michael Kerrisk (man-pages) wrote:
 On Sat, Dec 17, 2011 at 11:26 PM, Kalle Olavi Niemitalo k...@iki.fi wrote:
  The ioprio_get(2) manual page describes the meanings of the which
  and who parameters:
 
  IOPRIO_WHO_PROCESS
 who is a process ID identifying a single process.
 
  IOPRIO_WHO_PGRP
 who is a process group ID identifying all the members of
 a process group.
 
  The manual page should mention that IOPRIO_WHO_PROCESS and
  IOPRIO_WHO_PGRP also allow who==0.

 Yes.

  As implemented in
  fs/ioprio.c, who==0 means the calling process or its process
  group.  The ioprio program in util-linux already uses the
  feature.  This is worth documenting separately because
  e.g. tcsetpgrp does not treat pgrp==0 in that way.

 Agreed, this should be documented since various APIs interpret pgrp==0
 differently. Some (e.g., killpg(2)) are like this syscall, others are
 not.

 Documented by Michael in 82fdd7c7d0, already in manpages 3.42.

  IOPRIO_WHO_USER
 who is a user ID identifying all of the processes that
 have a matching real UID.
 
  For IOPRIO_WHO_USER, the situation is more complex: who==0 means
  the root user in ioprio_set but the current user (I think the
  real UID of the calling process) in ioprio_get.  (That
  inconsistency might even be a bug.)

 Remaning items as http://bugs.debian.org/691195

 --
 Simon Paillard




-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of The Linux Programming Interface; http://man7.org/tlpi/


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#691195: Bug#652443: ioprio_get(2): document who==0

2012-10-22 Thread Simon Paillard
Version: 3.42-1 

On Sun, Jul 29, 2012 at 08:32:49AM +0200, Michael Kerrisk (man-pages) wrote:
 On Sat, Dec 17, 2011 at 11:26 PM, Kalle Olavi Niemitalo k...@iki.fi wrote:
  The ioprio_get(2) manual page describes the meanings of the which
  and who parameters:
 
  IOPRIO_WHO_PROCESS
         who is a process ID identifying a single process.
 
  IOPRIO_WHO_PGRP
         who is a process group ID identifying all the members of
         a process group.
 
  The manual page should mention that IOPRIO_WHO_PROCESS and
  IOPRIO_WHO_PGRP also allow who==0.
 
 Yes.
 
  As implemented in
  fs/ioprio.c, who==0 means the calling process or its process
  group.  The ioprio program in util-linux already uses the
  feature.  This is worth documenting separately because
  e.g. tcsetpgrp does not treat pgrp==0 in that way.
 
 Agreed, this should be documented since various APIs interpret pgrp==0
 differently. Some (e.g., killpg(2)) are like this syscall, others are
 not.

Documented by Michael in 82fdd7c7d0, already in manpages 3.42.

  IOPRIO_WHO_USER
         who is a user ID identifying all of the processes that
         have a matching real UID.
 
  For IOPRIO_WHO_USER, the situation is more complex: who==0 means
  the root user in ioprio_set but the current user (I think the
  real UID of the calling process) in ioprio_get.  (That
  inconsistency might even be a bug.)

Remaning items as http://bugs.debian.org/691195 

-- 
Simon Paillard


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org