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