---
name: "nws_memory"
section: "1"
platform: "linux"
package: "nws"
version: "2.13-6.1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/nws_memory"
---

# nws\_memory(1)

memory for the Network Weather Service

## NAME

nws\_memory - memory for the Network Weather Service

## SYNOPSIS

**nws\_memory** \[-a addresses\]\[-n name\]\[-C cache\_entries\]\[-d directory\]\[-N host\]\[-s size\]\[-e file\]\[-l file\]\[-i file\]\[-f file\]\[-p port\]\[-B dbname\]\[-I seconds\]

## DESCRIPTION

This manual page explains the  **nws\_memory** program. A **[nws\_sensor(1)](/nws_sensor/1.md)** needs a **nws\_memory** instance to store its measurements. The **nws\_memory** stores measurements as data files in the current working directory or into a directory specified by the **-d** flag, one file per activity. The disk usage can grow high depending on the number of sensors registering. You may want to register the  **nws\_memory** with a  **[nws\_nameserver(1)](/nws_nameserver/1.md)**

You can retrieve data from a  **nws\_memory** using the command **[nws\_extract(1)](/nws_extract/1.md)**

## OPTIONS

- **-a** *addresses*

  Specified a comma separated list of addresses (IPs or name) that the  sensor will consider be aliases for the localhost. Used for multihomed  machine when DNS doesn't return all the IPs associated with a name.

- **-n** *name*

  Use  *name* as hostname. Useful the resolver aren't correctly configured and  gethostname doesn't return a resonable value.

- **-C howMany**

  Specifies how many entries to cache into memory: this can make the memory more responsive for queries.

- **-e file**

  Save the error messages to  *file.*

- **-l file**

  Save the log messages to  *file.*

- **-s howMany**

  Save only *howMany* entries per series. A small number will use less disk space at the expense of a shorter history.

- **-i file**

  Write the pid to  *file*

- **-N nws\_nameserver**

  Register this nws\_memory with *nws\_nameserver.*

- **-d directory**

  Use  *directory* as the directory to store the measurements. Every kind of measurement (as specified by activity) is grouped in the same file. The default directory is the current directory.

- **-p port**

  Listen to port instead of the default for the nws\_memory (8050).

- **-I idle**

  remove series that haven't been updated for more then *idle* seconds (defaults is to keep series forever).

- **-B dbname**

  Store the series into a database, one table per series. Right now this is an experimental feature and it works only with PostgreSQL database.

## BUGS

This man page doesn't explain all the possible options that the nws\_memory will obey.

Bugs list is at  http://nws.cs.ucsb.edu. ⟨http://nws.cs.ucsb.edu⟩

## AUTHOR

NWS is an original idea of Rich Wolski Rich Wolski (rich@cs.ucsb.edu) who came up with the original **nws\_memory.**

Neil Spring, Jim Hayes (jhayes@cs.ucsd.edu) and Martin Swany maintained and enhanced it.

Graziano Obertelli (graziano@cs.ucsb.edu) currently maintains NWS and wrote this man page.

## SEE ALSO

**[nws\_sensor(1)](/nws_sensor/1.md),** **[nws\_search(1)](/nws_search/1.md),** **[nws\_nameserver(1)](/nws_nameserver/1.md),** **[nws\_extract(1)](/nws_extract/1.md)**