aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFelix Johnson <fjohnson@felix-johnson.com>2026-02-27 00:45:03 +0000
committerAlexander Ziaee <ziaee@FreeBSD.org>2026-02-27 00:57:20 +0000
commit86dc5dd0b2a861cf9d8cad18fc17c17dbbfc4465 (patch)
tree7e87531b1fc56b544111dbd5ba3e948774a42bf9
parent7951411672fab14367d9e785bfc6fe7d9a29668c (diff)
newgrp.1: Provide examples
"These examples appear to be originally noted thirteen years ago by Mark Saad, contributed by eadler, put into a patch by Felix Johnson, and made into mdoc by myself. Finally, put this bug to rest." ~ziaee PR: 167742 Co-authored-by: eadler, ziaee, Mark Saad Differential Revision: https://reviews.freebsd.org/D48877
-rw-r--r--usr.bin/newgrp/newgrp.117
1 files changed, 16 insertions, 1 deletions
diff --git a/usr.bin/newgrp/newgrp.1 b/usr.bin/newgrp/newgrp.1
index d9701feef0d7..032aeb72616d 100644
--- a/usr.bin/newgrp/newgrp.1
+++ b/usr.bin/newgrp/newgrp.1
@@ -22,7 +22,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd February 8, 2013
+.Dd February 6, 2025
.Dt NEWGRP 1
.Os
.Sh NAME
@@ -67,6 +67,21 @@ exits >0.
Otherwise, the exit status of
.Nm
is the exit status of the shell.
+.Sh EXAMPLES
+Create a new group,
+.Ar foo ,
+with
+.Xr pw 8 :
+.Pp
+.Dl pw group add foo
+.Pp
+Set the group password:
+.Pp
+.Dl pw group mod foo -h 0
+.Pp
+As a non-root user, switch to the group:
+.Pp
+.Dl newgrp foo
.Sh SEE ALSO
.Xr csh 1 ,
.Xr groups 1 ,