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 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. 48.Sh FILES 49.Bl -tag -width /etc/group -compact 50.It Pa /etc/group 51group database file 52.El 53.Sh EXIT STATUS 54The 55.Nm 56utility returns 57.Dv EX_DATAERR 58if errors were found in the group file, 59and 60.Dv EX_OK 61otherwise. 62.Sh DIAGNOSTICS 63For each error found, 64.Nm 65will print an error message containing the name of the file being 66scanned and the line number on which the error was found. 67Otherwise no 68output is produced. 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 78The 79.Nm 80utility and this manual page were written by 81.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org . 82.Sh BUGS 83Should check fields more thoroughly for allowed/disallowed 84characters, and the range of the group ID. 85