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 Fl q 38.Op Ar groupfile 39.Sh DESCRIPTION 40The 41.Nm 42utility 43scans the given file or, failing that, the system-wide group file for 44errors. 45Specifically, it checks that every non-blank, non-comment 46entry is composed of four colon-separated fields, that none of them 47contains whitespace, and that the third field (the group ID) is 48numeric. 49It will also check for invalid characters in the group names 50and group members. 51The following options are available: 52.Bl -tag -width indent 53.It Fl q 54This option disables printing of text when the group format 55is correct. 56.El 57.Sh FILES 58.Bl -tag -width /etc/group -compact 59.It Pa /etc/group 60group database file 61.El 62.Sh EXIT STATUS 63The 64.Nm 65utility returns 66.Dv EX_DATAERR 67if errors were found in the group file, 68and 69.Dv EX_OK 70otherwise. 71.Sh DIAGNOSTICS 72For each error found, 73.Nm 74will print an error message containing the name of the file being 75scanned and the line number on which the error was found. 76.Sh SEE ALSO 77.Xr getgrent 3 , 78.Xr group 5 79.Sh HISTORY 80The 81.Nm 82utility appeared in 83.Fx 3.0 . 84.Sh AUTHORS 85.An -nosplit 86The 87.Nm 88utility and this manual page were written by 89.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org . 90Further functionality was added by 91.An Liam J. Foy Aq liamfoy@dragonflybsd.org . 92.Sh BUGS 93Should check the range of the group ID. 94