vmstatd(1)		   OpenBSD Reference Manual		    vmstatd(1)

NAME
     vmstatd - trace the kernel's dynamic memory usage

SYNOPSIS
     vmstatd [-d] [-f output] [-i interval]

DESCRIPTION
     The vmstatd utility polls the kernel for dynamic memory usage (from the
     malloc(9) family) and maintains a trace file, which is subsequently pro-
     cessed by the rrdvmstat(1) utility.  The arguments are as follows:

     -d		  Run the process in the foreground (don't daemonise).

     -f output	  Use output instead of the default output filename
		  /var/db/vmstatd.b.

     -i interval  Run at the specified interval instead of the default 5 sec-
		  onds.

     The default behaviour of the vmstatd utility is to daemonise and poll the
     kernel every 5 seconds.  The utility is terminated when it receives a
     SIGTERM.  Output is written to /var/db/vmstatd.db.

     Multiple invocations of vmstatd may be run concurrently, but if they
     don't each point to a different trace file, corruption will likely re-
     sult.

SIGNALS
     SIGTERM  Clean up and exit.

     SIGHUP   Immediately re-query the kernel for statistics and force the
	      database to flush to the disc.

     SIGINT   Clean up and exit (only when -d has been specified).

FILES
     /var/db/vmstatd.db	 The default vmstatd dump file.

EXAMPLES
     Run in the background and poll/update every 5 seconds (the default) to
     the default trace file:

	   # vmstatd

     To run in the foreground with fast updates, once per second, to a non-de-
     fault trace file:

	   # vmstatd -d -i1 -f trace.db

SEE ALSO
     rrdvmstat(1), top(1), vmstat(1), ps(1), systat(1)

OpenBSD 4.2			April 19, 2008				     1