SDRWATCH(1) ICI executables SDRWATCH(1)NAME
sdrwatch - SDR non-volatile data store activity monitor
SYNOPSIS
sdrwatch sdr_name interval count [ verbose ]
DESCRIPTION
For count interations, sdrwatch sleeps interval seconds and then invokes the sdr_print_trace() function (see sdr(3)) to report on SDR data
storage management activity in the SDR data store identified by sdr_name during that interval. If the optional verbose parameter is
specified, the printed SDR activity trace will be verbose as described in sdr(3).
If interval is zero, sdrwatch merely prints a current usage summary for the indicated data store and terminates.
sdrwatch is helpful for detecting and diagnosing storage space leaks.
EXIT STATUS
0 sdrwatch has terminated.
FILES
No configuration files are needed.
ENVIRONMENT
No environment variables apply.
DIAGNOSTICS
The following diagnostics may be issued to the ion.log log file:
Can't attach to sdr.
ION system error. One possible cause is that ION has not yet been initialized on the local computer; run ionadmin(1) to correct this.
Can't start trace.
Insufficient ION working memory to contain trace information. Reinitialize ION with more memory.
BUGS
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO sdr(3), psmwatch(1)perl v5.14.2 2012-05-25 SDRWATCH(1)
Check Out this Related Man Page
IONCONFIG(5) ICI configuration files IONCONFIG(5)NAME
ionconfig - ION node configuration parameters file
DESCRIPTION
ION node configuration parameters are passed to ionadmin in a file of parameter name/value pairs:
parameter_name parameter_value
Any line of the file that begins with a '#' character is considered a comment and is ignored.
ionadmin supplies default values for any parameters for which no value is provided in the node configuration parameters file.
The applicable parameters are as follows:
sdrName
This is the character string by which this ION node's SDR database will be identified. (Note that the SDR database infrastructure
enables multiple databases to be constructed on a single host computer.) The default value is "ion".
configFlags
This is the bitwise "OR" of the flag values that characterize the SDR database to use for this ION node. The default value is 1. The
SDR configuration flags are documented in detail in sdr(3). To recap:
1. The SDR is implemented in a region of shared memory. [Possibly with write-through to a file, for fault tolerance.]
2. The SDR is implemented as a file. [Possibly cached in a region of shared memory, for faster data retrieval.]
3. Transactions in the SDR are written ahead to a log, making them reversible.
4. SDR heap updates are not allowed to cross object boundaries.
heapKey
This is the shared-memory key by which the pre-allocated block of shared dynamic memory to be used as heap space for this SDR can be
located, if applicable. The default value is -1, i.e., not specified and not applicable.
pathName
This is the fully qualified path name of the directory in which are located (a) the file to be used as heap space for this SDR (which
will be created, if it doesn't already exist), in the event that the SDR is to be implemented in a file, and (b) the file to be used to
log the database updates of each SDR transaction, in the event that transactions in this SDR are to be reversible. The default value
is /usr/ion.
heapWords
This is the number of words (of 32 bits each on a 32-bit machine, 64 bits each on a 64-bit machine) of nominally non-volatile storage
to use for ION's SDR database. If the SDR is to be implemented in shared memory and no heapKey is specified, a block of shared memory
of this size will be allocated (e.g., by malloc()) at the time the node is created. If the SDR is to be implemented in a file and no
file named ion.sdr exists in the directory identified by pathName, then a file of this name and size will be created in this directory
and initialized to all binary zeroes. The default value is 250000 words (1 million bytes on a 32-bit computer).
wmKey
This is the shared-memory key by which this ION node's working memory will be identified. The default value is 65537.
wmAddress
This is the address of the block of dynamic memory -- volatile storage, which is not expected to persist across a system reboot -- to
use for this ION node's working memory. If zero, the working memory block will be allocated from system memory (e.g., by malloc()) at
the time the local ION node is created. The default value is zero.
wmSize
This is the size of the block of dynamic memory that will be used for this ION node's working memory. If wmAddress is zero, a block of
system memory of this size will be allocated (e.g., by malloc()) at the time the node is created. The default value is 5000000 (5
million bytes).
EXAMPLE
configFlags 1
heapWords 2500000
heapKey -1
pathName 'usr/ion'
wmSize 5000000
wmAddress 0
SEE ALSO ionadmin(1)perl v5.14.2 2012-06-11 IONCONFIG(5)