[Bug 1155695] Re: mq_overview(7) contains outdated, inaccurate fs.mqueue.queues_max limit description

[Michael Kerrisk]

On 02/19/2014 11:01 AM, Arto Bendiken wrote:
> Just to follow up on this, we have since abandoned the use of POSIX
> message queues altogether so this issue is no longer an ongoing concern
> for us.
> 
> Still, the mq_overview(7) man page continues to refer to the outdated,
> inaccurate queues_max hard limit (INT_MAX instead of 1024) at least as
> of Ubuntu 13.10.

Yes, it's been on my long TODO list to follow this up. Doc will get fixed,
and I hope the kernel too. Tell me, was this limitation the reason to 
abandon PMQs?


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to manpages in Ubuntu.
https://bugs.launchpad.net/bugs/1155695

Title:
  mq_overview(7) contains outdated, inaccurate fs.mqueue.queues_max
  limit description

Status in “manpages” package in Ubuntu:
  Confirmed

Bug description:
  The manpages 3.40-0.1ubuntu3 package in Ubuntu 12.10 contains an
  mq_overview(7) man page with outdated, severely inaccurate information
  regarding the /proc/sys/fs/mqueue/queues_max kernel limit, as follows:

  "The default value for queues_max is 256; it can be changed to any
  value in the range 0 to INT_MAX."

  This used to be true in Linux 3.2.x, as shipped in Ubuntu 12.04.
  However, it is no longer true with Linux 3.5.x, as shipped in 12.10.

  For some inexplicable reason, upstream lowered the hard upper limit
  for POSIX message queues (fs.mqueue.queues_max) from INT_MAX to 1024
  in the 3.5 kernel:

  # sysctl -w fs.mqueue.queues_max=1025
  sysctl: setting key "fs.mqueue.queues_max": Invalid argument
  fs.mqueue.queues_max = 1025

  You can verify the new, post-3.5 limit at:

  http://lxr.free-electrons.com/source/ipc/mq_sysctl.c?v=3.5#L40
  http://lxr.free-electrons.com/source/include/linux/ipc_namespace.h?v=3.5#L121

  Please amend the man page so that the new limit is correctly
  documented. The undocumented change from INT_MAX queues to a mere 1024
  queues is rather harsh, and it took quite some investigation to pin
  this down as an upstream kernel change.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1155695/+subscriptions