1.\" Copyright (c) 2008 The DragonFly Project. All rights reserved. 2.\" 3.\" This code is derived from software contributed to The DragonFly Project 4.\" by Matthew Dillon <dillon@backplane.com> 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in 14.\" the documentation and/or other materials provided with the 15.\" distribution. 16.\" 3. Neither the name of The DragonFly Project nor the names of its 17.\" contributors may be used to endorse or promote products derived 18.\" from this software without specific, prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 21.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 23.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 24.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 25.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, 26.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 27.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 28.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 29.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 30.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" SUCH DAMAGE. 32.\" 33.Dd October 16, 2008 34.Dt MONITOR 1 35.Os 36.Sh NAME 37.Nm monitor 38.Nd File and directory monitoring utility 39.Sh SYNOPSIS 40.Nm 41.Op Fl qvx 42.Ar 43.Sh DESCRIPTION 44The 45.Nm 46utility monitors one or more files or directories and outputs the 47appropriate file name to stdout whenever a change occurs. 48Supported options are as follows: 49.Bl -tag -width indent 50.It Fl q 51Be more quiet. 52Specifying this option will cause only the file paths to be output. 53.It Fl v 54Be more verbose. 55.It Fl x 56Exit after first hit. 57.Nm 58will exit after reporting the first event. 59.El 60.\".Sh EXAMPLES 61.\".Sh SEE ALSO 62.Sh HISTORY 63The 64.Nm 65utility first appeared in 66.Dx 2.1 . 67.Sh AUTHORS 68.An Matthew Dillon Aq Mt dillon@backplane.com 69