1.\" Copyright (c) 1998 Dag-Erling Coïdan 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.\" $FreeBSD$ 28.\" 29.Dd May 26, 2005 30.Dt CHKGRP 8 31.Os 32.Sh NAME 33.Nm chkgrp 34.Nd check the syntax of the group file 35.Sh SYNOPSIS 36.Nm 37.Op Ar groupfile 38.Sh DESCRIPTION 39The 40.Nm 41utility 42scans the given file or, failing that, the system-wide group file for 43errors. 44Specifically, it checks that every non-blank, non-comment 45entry is composed of four colon-separated fields, that none of them 46contains whitespace, and that the third field (the group ID) is 47numeric. 48It will also check for invalid characters in the group names 49and group members. 50.Sh FILES 51.Bl -tag -width /etc/group -compact 52.It Pa /etc/group 53group database file 54.El 55.Sh EXIT STATUS 56The 57.Nm 58utility returns 59.Dv EX_DATAERR 60if errors were found in the group file, 61and 62.Dv EX_OK 63otherwise. 64.Sh DIAGNOSTICS 65For each error found, 66.Nm 67will print an error message containing the name of the file being 68scanned and the line number on which the error was found. 69.Sh SEE ALSO 70.Xr getgrent 3 , 71.Xr group 5 72.Sh HISTORY 73The 74.Nm 75utility appeared in 76.Fx 3.0 . 77.Sh AUTHORS 78.An -nosplit 79The 80.Nm 81utility and this manual page were written by 82.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org . 83Further functionality was added by 84.An Liam J. Foy Aq liamfoy@dragonflybsd.org . 85.Sh BUGS 86Should check the range of the group ID. 87