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

# nws\_ctrl(1)

controls Network Weather Service processes

## NAME

nws\_ctrl - controls Network Weather Service processes

## SYNOPSIS

**nws\_ctrl** \[-t seconds\]\[-P password\]\[-f file\]\[-V\]\[-v #\]\[-N host\] command host \[command-options\]

## DESCRIPTION

This manual page explains the  **nws\_ctrl** program. With **nws\_ctrl** you can control NWS processes, for example stopping it, or instructing a sensor to register with a different nameserver, or modifying the clique structure.

The  **host** after the command is the recipient of the message, everything else after that is options for the specific command.

Here is a list of commands you can specify

**register**

direct the NWS process to register with a new NWS nameserver. The new NWS nameserver is the only command option (has to be present).

**memory**

direct the NWS process to use a new NWS memory to store experiments. The new NWS memory is the only command option (has to be present).

**halt**

directs the NWS process to exit.

**stop**

stop an activity. The only options allowed (a part from the host) is the activity name to stop. If  *host* is a nameserver, query it to find who is responsible for the activity and contact it to stop it.

**start**

start an activity on sensor *host.* The options here are the usual NWS format \<attribute\>:\<name\> and at least *name, controlName* and *skillName* have to be present. Others attribute are optional and depends on the particular activity to be started.

**log**

directs the NWS process to suppress or resume error message output. It accepts 1 options that can be  *error* or *log* that specifies wich diagnostics needs to be toggle. No options meas all diagnostics will be toggle.

**add**

asks a remote sensor to add a new host to a running clique: the clique needs to be already running. The first options is the clique name and the second options is the host to add.

**remove**

asks a remote sensor to remove a new host to a running clique: the clique needs to be already running. The first options is the clique name and the second options is the host to remove.

**fetch**

asks a nws proxy (host) to start autofetching (monitoring) the specific resource (the first option) for all the hosts (all the other options are the hosts).

**fetchClique**

asks a nws proxy (host) to start autofetching (monitoring) for all the hosts belonging to clique (where clique is the first and only option).

**clean**

asks a memory (host) to remove series that have been not update for the past *idle* seconds. The second parameter is the idle time and the reminders are the series lists.

## OPTIONS

- **-t timeout**

  **wait to connect to host for only**  *timeout.* seconds

- **-f file**

  after reading the command line, read  *file* for options.

- **-N host**

  use *host* as **[nws\_nameserver(1)](/nws_nameserver/1.md)** to query. Multiple nameserver might be specified (using multiple -N option).

- **-V**

  print the version number.

- **-v level**

  specifies the verbosity while issuing NWS commands.  *level* can be up to 5.

## EXAMPLES

**To instruct a sensor (A) to register with a different nameserver (B)**

nws\_ctrl register A B

To instruct a sensor (A) to add a sensor (B) to an already running clique named C

nws\_ctrl add A B C

## BUGS

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).

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)**