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: src/usr.sbin/chkgrp/chkgrp.8,v 1.7.2.3 2001/08/16 15:55:42 ru Exp $ 28.\" 29.Dd May 5, 1998 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. It will also check for invalid characters in the group names 48and group members. 49.Sh FILES 50.Bl -tag -width /etc/group -compact 51.It Pa /etc/group 52group database file 53.El 54.Sh DIAGNOSTICS 55For each error found, 56.Nm 57will print an error message containing the name of the file being 58scanned and the line number on which the error was found. 59.Pp 60The 61.Nm 62utility returns 63.Dv EX_DATAERR 64if errors were found in the group file, 65and 66.Dv EX_OK 67otherwise. 68.Sh SEE ALSO 69.Xr getgrent 3 , 70.Xr group 5 71.Sh HISTORY 72The 73.Nm 74utility appeared in 75.Fx 3.0 . 76.Sh AUTHORS 77.An -nosplit 78The 79.Nm 80utility and this manual page were written by 81.An Dag-Erling Co\(:idan Sm\(/orgrav Aq Mt des@FreeBSD.org . 82.Pp 83Further functionality was added by 84.An Liam J. Foy Aq Mt liamfoy@dragonflybsd.org . 85.Sh BUGS 86Should check the range of the group ID. 87