PTS_SETMAX(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 PTS_SETMAX(1) — AFS Command Reference ✨

okay bestie, so this is pts_setmax, and yes it lives in the AFS Command Reference corner of the manual-verse. she sets the value of the max group id or max user id counter. lowkey iconic, highkey important. let's get into it 🫶

🎀 NAME

pts_setmax — sets the value of the max group id or max user id counter

🌸 SYNOPSIS

pts setmax [-group <group max>] [-user <user max>]
    [-cell <cell name>] [-noauth] [-localauth] [-force] [-help]
    [-auth] [-encrypt] [-config <config directory>]

pts setm [-g group max>] [-u <user max>]
    [-c <cell name>] [-n] [-l] [-f] [-h]
    [-a] [-e] [-co <config directory>]
bestie I am begging you to notice that second synopsis line says [-g group max>]. that is not a typo I made, that is character for character what the page says. we do not fix the original in this household. periodt 💅

🦋 DESCRIPTION

so the pts setmax command sets the value of one or both of the counters that keep track of the IDs the Protection Server hands out to new users, machines, or groups. there are two of them, and they are:

  • the "max user id" counter — this is for the AFS user IDs (AFS UIDs) that get assigned to users and machines 💖
  • the "max group id" counter — this is for the AFS group IDs (AFS GIDs) that get assigned to groups ✨

and if you wanna see what those counters are currently set to? run the pts listmax command, she'll show you both. no guessing, no vibes-based math, just look at them. 👑

✨ OPTIONS ✨

  • -group <group max> — sets the "max group id" counter. if the value is negative, you gotta put a hyphen in front of it to signal that, okay? 🩷 so here's the tea: when an administrator next runs the pts creategroup command to make a group entry and doesn't include that command's -id argument, the Protection Server gives that group an AFS GID that's one less (more negative) than this value. yes, less. direction matters bestie, do not mix them up 😭
  • -user <user max> — sets the "max user id" counter. and when an administrator next runs the pts createuser command to create a user or machine entry and doesn't include that command's -id argument, the Protection Server assigns the group an AFS UID one greater than this value. (fr fr, the original really does say "assigns the group an AFS UID" right here — I'm just carrying her words across the finish line 🏃♀️💨)
  • -auth — uses the calling user's tokens to talk to the Protection Server. want the whole lore? see pts(1). 🔐
  • -cell <cell name> — names the cell where the command should run. more details live in pts(1). 🗺️
  • -config <config directory> — use an alternate config directory. again, pts(1) has the full story. 📁
  • -encrypt — encrypts any communication with the Protection Server. details? pts(1). the girl is secure. 🔒
  • -force — lets the command keep going as far as it possibly can when errors or other problems pop up, instead of just halting at the very first error. she's resilient like that 💪
  • -help — prints the online help for this command. and heads up: all other valid options are ignored when you use this one. she does not multitask 🙈
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. ⚠️ do NOT combine this flag with the -cell or -noauth options. like, genuinely, don't. for more details, see pts(1).
  • -noauth — assigns the unprivileged identity anonymous to the issuer. more details in pts(1). 👻

🌈 EXAMPLES

so the following command sets the "max group id" counter to -500 and the "max user id" counter to 1000. watch her work:

% pts setmax -group -500 -user 1000

slay. ate. no crumbs. 🍓

👑 PRIVILEGE REQUIRED

the issuer must belong to the system:administrators group. that's the rule, bestie, I don't make them 💅

🌟 SEE ALSO

pts(1), pts_creategroup(1), pts_createuser(1), pts_listmax(1)

the whole friend group, all linked up 🫶

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

okay that's the whole page, bestie!! 🎀 this little beauty is from OpenAFS, dated 2026-07-27 — go forth and set those counters, you absolute main character 👑💖 mwah, bye!! 🌸✨

📦 where this page comes from