Bug 167742 - Update documentation for group 5, and newgrp 1
Summary: Update documentation for group 5, and newgrp 1
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords: easy, patch
Depends on:
Blocks:
 
Reported: 2012-05-09 17:20 UTC by Mark Saad
Modified: 2022-09-15 04:38 UTC (History)
3 users (show)

See Also:

Attachments
newgrp(1) patch (670 bytes, patch)
2021-09-20 03:10 UTC, Felix Johnson 		no flags Details | Diff
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Mark Saad 2012-05-09 17:20:11 UTC 
	The man pages for both group 5 and newgrp 1 do not include examples of how to use group passwords.

Fix: 

eadler@freebsd.org stated that a short example similar to this would do in the newgrp man page

Create the group
% pw group add foo

Set the group password
% pw group mod foo -h 0

As a non root user switch to the group
% newgrp foo

Also in the group 5 man the See Also section should include a refrence to newgrp 1
How-To-Repeat: 	See man 1 newgrp and man 5 group
Comment 1 Joel Dahl freebsd_committer freebsd_triage 2013-04-20 23:44:29 UTC 
Responsible Changed
From-To: freebsd-doc->joel

Take.
Comment 2 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 07:58:23 UTC 
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped
Comment 3 Felix Johnson freebsd_triage 2021-09-20 03:10:50 UTC 
Created attachment 228037 [details]
newgrp(1) patch

Add an example of creating a group, setting a group password, and switching to the new group.
Comment 4 Felix Johnson freebsd_triage 2021-09-20 03:11:58 UTC 
group(5) has a cross-reference to newgrp(1) in the SEE ALSO section.