xref: /dflybsd-src/usr.bin/monitor/monitor.1 (revision fb3c2c0caaaa0e5d800e088b7dd7983e9ab009ec)
11e3b54fcSMatthew Dillon.\" Copyright (c) 2008 The DragonFly Project.  All rights reserved.
21e3b54fcSMatthew Dillon.\"
31e3b54fcSMatthew Dillon.\" This code is derived from software contributed to The DragonFly Project
41e3b54fcSMatthew Dillon.\" by Matthew Dillon <dillon@backplane.com>
51e3b54fcSMatthew Dillon.\"
61e3b54fcSMatthew Dillon.\" Redistribution and use in source and binary forms, with or without
71e3b54fcSMatthew Dillon.\" modification, are permitted provided that the following conditions
81e3b54fcSMatthew Dillon.\" are met:
91e3b54fcSMatthew Dillon.\"
101e3b54fcSMatthew Dillon.\" 1. Redistributions of source code must retain the above copyright
111e3b54fcSMatthew Dillon.\"    notice, this list of conditions and the following disclaimer.
121e3b54fcSMatthew Dillon.\" 2. Redistributions in binary form must reproduce the above copyright
131e3b54fcSMatthew Dillon.\"    notice, this list of conditions and the following disclaimer in
141e3b54fcSMatthew Dillon.\"    the documentation and/or other materials provided with the
151e3b54fcSMatthew Dillon.\"    distribution.
161e3b54fcSMatthew Dillon.\" 3. Neither the name of The DragonFly Project nor the names of its
171e3b54fcSMatthew Dillon.\"    contributors may be used to endorse or promote products derived
181e3b54fcSMatthew Dillon.\"    from this software without specific, prior written permission.
191e3b54fcSMatthew Dillon.\"
201e3b54fcSMatthew Dillon.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
211e3b54fcSMatthew Dillon.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
221e3b54fcSMatthew Dillon.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
231e3b54fcSMatthew Dillon.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
241e3b54fcSMatthew Dillon.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
251e3b54fcSMatthew Dillon.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
261e3b54fcSMatthew Dillon.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
271e3b54fcSMatthew Dillon.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
281e3b54fcSMatthew Dillon.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
291e3b54fcSMatthew Dillon.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
301e3b54fcSMatthew Dillon.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
311e3b54fcSMatthew Dillon.\" SUCH DAMAGE.
321e3b54fcSMatthew Dillon.\"
331e3b54fcSMatthew Dillon.Dd October 16, 2008
341e3b54fcSMatthew Dillon.Dt MONITOR 1
351e3b54fcSMatthew Dillon.Os
361e3b54fcSMatthew Dillon.Sh NAME
371e3b54fcSMatthew Dillon.Nm monitor
381e3b54fcSMatthew Dillon.Nd File and directory monitoring utility
391e3b54fcSMatthew Dillon.Sh SYNOPSIS
401e3b54fcSMatthew Dillon.Nm
411e3b54fcSMatthew Dillon.Op Fl qvx
42902f7135SSascha Wildner.Ar
431e3b54fcSMatthew Dillon.Sh DESCRIPTION
441e3b54fcSMatthew DillonThe
451e3b54fcSMatthew Dillon.Nm
461e3b54fcSMatthew Dillonutility monitors one or more files or directories and outputs the
471e3b54fcSMatthew Dillonappropriate file name to stdout whenever a change occurs.
481e3b54fcSMatthew DillonSupported options are as follows:
491e3b54fcSMatthew Dillon.Bl -tag -width indent
501e3b54fcSMatthew Dillon.It Fl q
511e3b54fcSMatthew DillonBe more quiet.
521e3b54fcSMatthew DillonSpecifying this option will cause only the file paths to be output.
531e3b54fcSMatthew Dillon.It Fl v
541e3b54fcSMatthew DillonBe more verbose.
551e3b54fcSMatthew Dillon.It Fl x
561e3b54fcSMatthew DillonExit after first hit.
571e3b54fcSMatthew Dillon.Nm
581e3b54fcSMatthew Dillonwill exit after reporting the first event.
591e3b54fcSMatthew Dillon.El
601e3b54fcSMatthew Dillon.\".Sh EXAMPLES
611e3b54fcSMatthew Dillon.\".Sh SEE ALSO
621e3b54fcSMatthew Dillon.Sh HISTORY
631e3b54fcSMatthew DillonThe
641e3b54fcSMatthew Dillon.Nm
651e3b54fcSMatthew Dillonutility first appeared in
661e3b54fcSMatthew Dillon.Dx 2.1 .
671e3b54fcSMatthew Dillon.Sh AUTHORS
68*b4f25088SFranco Fichtner.An Matthew Dillon Aq Mt dillon@backplane.com
69