Bug 100196

Summary: man login.conf does explain not "unlimited"
Product: Documentation Reporter: Dr. Markus Waldeck <waldeck>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Dr. Markus Waldeck 2006-07-13 08:50:19 UTC 
The examples in /etc/login.conf use two possible values for "unlimited" (unlimited and infinity).

A look in the source code (usr.bin/limits/limits.c, Revision 1.14, line 497 - 500) reveals that there a FOUR possible values to express unlimited:
- inf
- infinity
- unlimit
- unlimited

Unfortunately there is no explanation in man login.conf at all.

Fix: 

Add the explanation.
How-To-Repeat: man login.conf
Comment 1 jamie.landeg.jones 2013-10-27 01:03:38 UTC 
I too noticed this, and googled 'login.conf unlimited infinity' to check if
there was actually any subtle difference between the two. (Hence finding
this PR)

The default login.conf uses both forms.

Cheers,
      Jamie
Comment 2 dfilter service freebsd_committer freebsd_triage 2013-10-27 04:59:25 UTC 
Author: eadler
Date: Sun Oct 27 04:59:18 2013
New Revision: 257205
URL: http://svnweb.freebsd.org/changeset/base/257205

Log:
  Mention in login.conf.5 which fields may be infinite and how to specifify infinity.
  The number of ways to indicate this confuses people.
  
  PR:		docs/100196
  Reported by:	"Dr. Markus Waldeck" <waldeck@gmx.de>
  Reported by:	Jamie Landeg Jones <jamie.landeg.jones@gmail.com>

Modified:
  head/lib/libutil/login.conf.5

Modified: head/lib/libutil/login.conf.5
==============================================================================
--- head/lib/libutil/login.conf.5	Sun Oct 27 04:49:40 2013	(r257204)
+++ head/lib/libutil/login.conf.5	Sun Oct 27 04:59:18 2013	(r257205)
@@ -130,6 +130,7 @@ tag being delimited from the value by '=
 Whichever method is used, then all records in the database must use the
 same method to allow values to be correctly overridden in interpolated
 records.
+A numeric value may be infinite.
 .It size
 A number which expresses a size.
 The default interpretation of a value is the number of bytes, but a
@@ -148,6 +149,7 @@ represents terabytes.
 .El
 A size value is a numeric quantity and case of the suffix is not significant.
 Concatenated values are added together.
+A size value may be infinite.
 .It time
 A period of time, by default in seconds.
 A prefix may specify a different unit:
@@ -168,8 +170,16 @@ the number of seconds.
 Concatenated values are added together.
 For example, 2 hours and 40 minutes may be written either as
 9600s, 160m or 2h40m.
+A time value may be infinite.
 .El
 .Pp
+.Dq infinity ,
+.Dq inf ,
+.Dq unlimited ,
+.Dq unlimit,
+and -1
+are considered infinite values.
+.Pp
 The usual convention to interpolate capability entries using the special
 .Em tc=value
 notation may be used.
_______________________________________________
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 Eitan Adler freebsd_committer freebsd_triage 2013-10-27 05:09:12 UTC 
State Changed
From-To: open->patched

I've changed the man page in r257205; it will be merged to {8,9,10} 
shortly