PTS_INTERACTIVE(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

✨ PTS_INTERACTIVE ✨

okay bestie, this is a page from the AFS Command Reference — it's pts_interactive, manual section 1, and it's about the lil' gateway into interactive mode 💅

🌸 NAME 🌸

pts_interactive — Enters interactive mode

🎀 SYNOPSIS 🎀

pts interactive [-cell] <cell name> [-noauth]
    [-auth] [-localauth] [-force] [-help]
    [-encrypt] [-config <config directory>]

pts in [-c] <cell name> [-n] [-f] [-h]
    [-a] [-e] [-co <config directory>]

🦋 DESCRIPTION 🦋

So pts interactive is literally the door into an interactive mode, and it's giving bulk-command main character energy — like when you gotta create a whole bunch of new users or groups and you do NOT wanna type the whole command fifty times 🙈

Here's the vibe: pts interactive takes the authentication state you handed it on its own command line, and uses that for all the bulk commands. But!! if one of your bulk commands comes with authentication options of its own — like -cell, -localauth, -auth or -noauth — then that command, and every bulk command after it, runs with those options instead. noted. periodt. ✨

💀 CAUTIONS 💀

Real talk, bestie, read this part.

Back before OpenAFS 1.4.5 and OpenAFS 1.5.23, pts interactive was only a thing on Unix or Linux, and only when OpenAFS was compiled with the supergroups option (which, btw, is disabled by default). But as of OpenAFS 1.4.5 and 1.5.23, it's always available. slay.

Also — and this is the important one — running bulk pts commands may degrade the performance of the Protection Server while they're running, and the server resources may not be released immediately after the commands are run. 😭 That's why there's the pts sleep command: you can use it in interactive mode or with pts source to give the Protection Server a hot second to catch up. be nice to your server. 🫶

👑 OPTIONS 👑

pts interactive only takes the standard pts options. that's it, that's the menu 💅

  • -auth — Uses the calling user's tokens to talk to the Protection Server. For more details, go see pts(1).
  • -cell <cell name> — Names the cell where the command should run. For more details, see pts(1).
  • -config <config directory> — Uses an alternate config directory. For more details, see pts(1).
  • -encrypt — Encrypts any communication with the Protection Server. For more details, see pts(1).
  • -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. 💪
  • -help — Prints the online help for this command. Every other valid option gets ignored when you use this one.
  • -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, bestie, I'm begging 😭 For more details, see pts(1).
  • -noauth — Assigns the unprivileged identity anonymous to the issuer. For more details, see pts(1).

🌈 OUTPUT 🌈

The output is the same as if each individual command were run straight from the command line. no notes. ✨

🍓 EXAMPLES 🍓

Here's what a pts interactive session looks like, bestie:

% pts interactive
pts> examine admin
Name: admin, id: 1, owner: system:administrators, creator: anonymous,
  membership: 2, flags: S----, group quota: 20.
pts> help
pts: Commands are:
adduser         add a user to a group
apropos         search by help text
chown           change ownership of a group
creategroup     create a new group
createuser      create a new user
delete          delete a user or group from database
examine         examine an entry
help            get help on commands
interactive     enter interactive mode
listentries     list users/groups in the protection database
listmax         list max id
listowned       list groups owned by an entry or zero id gets orphaned groups
membership      list membership of a user or group
quit            exit program
removeuser      remove a user from a group
rename          rename user or group
setfields       set fields for an entry
setmax          set max id
sleep           pause for a bit
source          read commands from file
pts> quit
%

🧚 PRIVILEGE REQUIRED 🧚

The same privilege you need to run the command in interactive mode is the same privilege you need to run it by itself on the command line. Some commands — like pts createuser, for example — require that the user belong to the system:administrators group, while others just don't. iykyk 💜

⭐ SEE ALSO ⭐

pts(1), pts_quit(1), pts_sleep(1), pts_source(1), ptserver(8)

Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS.

and that's the whole page, bestie 🎀 thanks for reading the whole thing, you ate. this was OpenAFS, dated 2026-07-27 — go forth and bulk-create your users responsibly 💅✨

📦 where this page comes from