| 1 |
.\" $MidnightBSD$ |
| 2 |
.\" Copyright (c) 1998 Dag-Erling Coïdan Smørgrav |
| 3 |
.\" All rights reserved. |
| 4 |
.\" |
| 5 |
.\" Redistribution and use in source and binary forms, with or without |
| 6 |
.\" modification, are permitted provided that the following conditions |
| 7 |
.\" are met: |
| 8 |
.\" 1. Redistributions of source code must retain the above copyright |
| 9 |
.\" notice, this list of conditions and the following disclaimer |
| 10 |
.\" in this position and unchanged. |
| 11 |
.\" 2. Redistributions in binary form must reproduce the above copyright |
| 12 |
.\" notice, this list of conditions and the following disclaimer in the |
| 13 |
.\" documentation and/or other materials provided with the distribution. |
| 14 |
.\" 3. The name of the author may not be used to endorse or promote products |
| 15 |
.\" derived from this software without specific prior written permission |
| 16 |
.\" |
| 17 |
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
| 18 |
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| 19 |
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
| 20 |
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
| 21 |
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
| 22 |
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 23 |
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 24 |
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 25 |
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
| 26 |
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 27 |
.\" |
| 28 |
.\" $FreeBSD: stable/10/usr.sbin/chkgrp/chkgrp.8 243084 2012-11-15 15:16:50Z eadler $ |
| 29 |
.\" |
| 30 |
.Dd May 26, 2005 |
| 31 |
.Dt CHKGRP 8 |
| 32 |
.Os |
| 33 |
.Sh NAME |
| 34 |
.Nm chkgrp |
| 35 |
.Nd check the syntax of the group file |
| 36 |
.Sh SYNOPSIS |
| 37 |
.Nm |
| 38 |
.Op Fl q |
| 39 |
.Op Ar groupfile |
| 40 |
.Sh DESCRIPTION |
| 41 |
The |
| 42 |
.Nm |
| 43 |
utility |
| 44 |
scans the given file or, failing that, the system-wide group file for |
| 45 |
errors. |
| 46 |
Specifically, it checks that every non-blank, non-comment |
| 47 |
entry is composed of four colon-separated fields, that none of them |
| 48 |
contains whitespace, and that the third field (the group ID) is |
| 49 |
numeric. |
| 50 |
It will also check for invalid characters in the group names |
| 51 |
and group members. |
| 52 |
The following options are available: |
| 53 |
.Bl -tag -width indent |
| 54 |
.It Fl q |
| 55 |
This option disables printing of text when the group format |
| 56 |
is correct. |
| 57 |
.El |
| 58 |
.Sh FILES |
| 59 |
.Bl -tag -width /etc/group -compact |
| 60 |
.It Pa /etc/group |
| 61 |
group database file |
| 62 |
.El |
| 63 |
.Sh EXIT STATUS |
| 64 |
The |
| 65 |
.Nm |
| 66 |
utility returns |
| 67 |
.Dv EX_DATAERR |
| 68 |
if errors were found in the group file, |
| 69 |
and |
| 70 |
.Dv EX_OK |
| 71 |
otherwise. |
| 72 |
.Sh DIAGNOSTICS |
| 73 |
For each error found, |
| 74 |
.Nm |
| 75 |
will print an error message containing the name of the file being |
| 76 |
scanned and the line number on which the error was found. |
| 77 |
.Sh SEE ALSO |
| 78 |
.Xr getgrent 3 , |
| 79 |
.Xr group 5 |
| 80 |
.Sh HISTORY |
| 81 |
The |
| 82 |
.Nm |
| 83 |
utility appeared in |
| 84 |
.Fx 3.0 . |
| 85 |
.Sh AUTHORS |
| 86 |
.An -nosplit |
| 87 |
The |
| 88 |
.Nm |
| 89 |
utility and this manual page were written by |
| 90 |
.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org . |
| 91 |
Further functionality was added by |
| 92 |
.An Liam J. Foy Aq liamfoy@dragonflybsd.org . |
| 93 |
.Sh BUGS |
| 94 |
Should check the range of the group ID. |
