OCPASSWD(8)

πŸ’– OCPASSWD β€” the ocpasswd girlies' guide πŸ’–

okay so bestie, welcome to ocpasswd, aka the OpenConnect server password utility from the System Manager's Manual (section 8, so you know it's admin business πŸ‘‘). Sit down, grab a strawberry πŸ“, and let's get into it.


✨ NAME ✨

ocpasswd β€” OpenConnect server password utility


🌸 SYNOPSIS 🌸

ocpasswd [ -flag [value] | --option-name[[=| ]value] ]... username
fr fr, that bracket situation is just saying: you can stack flags, long options can take a value glued on with = or separated by a space, and you always end with a username. That's the vibe. πŸ’…

πŸ¦‹ DESCRIPTION πŸ¦‹

So this program is the openconnect password (ocpasswd) utility. What does it do? It lets you generate and handle a 'plain' password file β€” the one ocserv uses. That's literally the whole job and it eats every time. 😌✨


πŸ’… OPTIONS πŸ’…

  • -c, --passwd=FILE β€” pick which password file you're working with. Only useful when you're not using the default location, bestie. The default is /etc/ocserv/ocpasswd. πŸ—‚οΈ
  • -g, --group β€” set the user's group name. Heads up though: groups that are just one single character, like '*' and 'x', get ignored. Not us. They're ignored. πŸ™ˆ
  • -d, --delete β€” deletes the specified user from the password file. gone. poof. πŸ’€
  • -l, --lock β€” prevents the specified user from logging in by locking their password. πŸš«πŸ”’
  • -u, --unlock β€” re-enables login for the specified user by unlocking their password. welcome back queen πŸ‘‘πŸ”“
  • -h, --help β€” display usage information and exit. your friendly lil helper 🫢
  • -v, --version β€” output version of program and exit. πŸ“Œ

πŸ”₯ EXIT STATUS πŸ”₯

  • 0 β€” successful program execution. slay. ✨
  • 1 β€” the operation failed or the command syntax was not valid. it's giving error energy 😭

πŸŽ€ FILES πŸŽ€

The password format of ocpasswd is as follows:

username:groupname:encoded-password

And the crypt(3) encoding is used for the encoded-password. no cap, that's just how it be. πŸ”


🌈 EXAMPLES 🌈

Adding a user 🧚

$ ocpasswd -c ocpasswd my_username

Locking a user πŸ”’

$ ocpasswd -c ocpasswd -l my_username

Unlocking a user πŸ”“

$ ocpasswd -c ocpasswd -u my_username

πŸ’œ AUTHORS πŸ’œ

Written by Nikos Mavrogiannopoulos. Many people have contributed to it. iconic collaborative behavior, honestly. πŸ‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

Issue tracker: https://gitlab.com/openconnect/ocserv/-/issues

found a bug? not me ignoring it β€” go tell the tracker bestie 🫢

Copyright (C) 2013-2024 Nikos Mavrogiannopoulos and others, all rights reserved. This program is released under the terms of the GNU General Public License, version 2. πŸ“œβœ¨


πŸ‘‘ SEE ALSO πŸ‘‘

ocserv(8), occtl(8)


and that's the whole page, babe πŸ’– this was the OCPASSWD(8) page from the System Manager's Manual, dated June 2026 β€” go forth and manage those passwords responsibly, main character πŸ¦‹πŸŒΈπŸ’…

πŸ“¦ where this page comes from