[Bug 284961] $name in jail.conf is empty if it's a number

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=284961

            Bug ID: 284961
           Summary: $name in jail.conf is empty if it's a number
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: buero28@icloud.com
                CC: doc@FreeBSD.org

If only numbers [0-9] are used for the jail name in jail.conf. There is only
the
JID existent. The $name variable is empty.

Steps for testing:

1. Create a jail like 100 { parameter="value"; ...}
2. Try to use the name variable 100 { parameter="$name"; ...} -> fails name is
empty
3. Try to set the JID 100 { jid="3"; ...} -> fails JID already 100

Notes from the Jails Production User call (28.01.2025)

From jail(8):
      name    The jail  name.  This is an arbitrary string that  identifies  a
               jail  (except  it may not contain a `.').  Like the jid, it can
               be passed to later jail commands, or to jls(8) or jexec(8).  If
               no name is supplied, a default is assumed that is the  same  as
               the  jid.   The  name  parameter is implied by the jail.conf(5)
               file format, and need not be explicitly set when using the con-
               figuration file.

jail.conf(5)
       This  is  used by jail(8) to specify a jail on the command line and re-
       port the jail status, and is also passed to the  kernel  when  creating
       the jail.

       Suggestion? "If name parameter is unbound, but the JID is, expand name
       to JID" name = JID is the current workaround? Jail block name controls
       the jail name? Can't name it within the configuration block?

ROUGHLY/VERIFY: If the name is only made of numerical values, the JID will be
equal to that value and the name variable will not be assigned. The user must
assign the name variable manually with name = $jid, or use the JID variable
instead of the name variable.

see:
https://docs.google.com/document/d/1kVYiLhWjql3kguHFaG41Q8xlBX5dujHCyiIcFOKTC8Y/edit?tab=t.0

-- 
You are receiving this mail because:
You are on the CC list for the bug.