Changeset View
Changeset View
Standalone View
Standalone View
usr.sbin/pw/pw.8
| Show All 24 Lines | |||||
| .Dd August 19, 2025 | .Dd August 19, 2025 | ||||
| .Dt PW 8 | .Dt PW 8 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm pw | .Nm pw | ||||
| .Nd create, remove, modify & display system users and groups | .Nd create, remove, modify & display system users and groups | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .Nm | .Nm | ||||
| .Op Fl M Ar metalog | |||||
| .Op Fl R Ar rootdir | .Op Fl R Ar rootdir | ||||
| .Op Fl V Ar etcdir | .Op Fl V Ar etcdir | ||||
| .Cm useradd | .Cm useradd | ||||
| .Oo Fl n Oc Ar name | .Oo Fl n Oc Ar name | ||||
| .Op Fl mNoPq | .Op Fl mNoPq | ||||
| .Op Fl C Ar config | .Op Fl C Ar config | ||||
| .Op Fl c Ar comment | .Op Fl c Ar comment | ||||
| .Op Fl d Ar homedir | .Op Fl d Ar homedir | ||||
| ▲ Show 20 Lines • Show All 418 Lines • ▼ Show 20 Lines | |||||
| it will by default be a subdirectory of the | it will by default be a subdirectory of the | ||||
| .Ar basehome | .Ar basehome | ||||
| directory as specified by the | directory as specified by the | ||||
| .Fl b | .Fl b | ||||
| option, bearing the name of the new account. | option, bearing the name of the new account. | ||||
| This can be overridden by the | This can be overridden by the | ||||
| .Fl d | .Fl d | ||||
| option on the command line, if desired. | option on the command line, if desired. | ||||
| .It Fl M Ar metalog | |||||
| Specify a path to a | |||||
| .Xr mtree 5 | |||||
| metalog file. | |||||
| .Nm | |||||
| will add entries for all files added to a user's home directory. | |||||
| This is useful when building images as a non-root user, as the | |||||
| metalog can be used as input to | |||||
| .Xr tar 1 | |||||
| or | |||||
| .Xr makefs 8 . | |||||
| Note that this option must precede the | |||||
| .Ql useradd | |||||
| string on the command line, otherwise it will be interpreted as the mode | |||||
| option. | |||||
| .It Fl M Ar mode | .It Fl M Ar mode | ||||
| Create the user's home directory with the specified | Create the user's home directory with the specified | ||||
| .Ar mode , | .Ar mode , | ||||
| modified by the current | modified by the current | ||||
| .Xr umask 2 . | .Xr umask 2 . | ||||
| If omitted, it is derived from the parent process' | If omitted, it is derived from the parent process' | ||||
| .Xr umask 2 . | .Xr umask 2 . | ||||
| This option is only useful in combination with the | This option is only useful in combination with the | ||||
| ▲ Show 20 Lines • Show All 626 Lines • Show Last 20 Lines | |||||