SYSMOD(1) | General Commands Manual | SYSMOD(1)

# NAME

`sysmod` —
modify INGRES system relations to optimal storage structures

# SYNOPSIS

`sysmod` | [`-s`] [`-+-w`] dbname [`relation`] [`attribute`] [`indexes`] [`tree`] [`protect`] [`integrities`]

# DESCRIPTION

The `sysmod` utility modifies the system catalog relations (relation, attribute, indexes, tree, protect, and integrities) to hash storage structures for maximum access performance when running INGRES.

If one or more of the `relation`, `attribute`, `indexes`, `tree`, `protect`, or `integrities` parameters are given, only those relations are modified. Otherwise, all system relations are modified.

The user must be the database administrator for the specified database, or be the INGRES superuser and have the `-s` flag stated.

The `sysmod` utility should be run on a database when it is first created and periodically thereafter to maintain peak performance. If many relations and secondary indices are created and/or destroyed, `sysmod` should be run more often.

The `sysmod` utility will lock the database while it is being processed, since errors will occur if the database is active while `sysmod` is running.

The options are as follows:

`-s`
  Allow the INGRES superuser to run `sysmod` on any database.
`-+-w`
  Control database wait behavior. If `-w` is stated, `sysmod` will not wait for a busy database regardless of standard input. If `+w` is stated, `sysmod` will always wait. If omitted and standard input is not a terminal, `sysmod` will wait for the database to be free.

The system relations are modified to hash. The relation relation is keyed on the first domain. The indexes, attribute, protect, and integrities relations are keyed on the first two domains. The tree relation is keyed on domains one, two, and five. The relation and attribute relations have the minpages option set to 10; the indexes, protect, and integrities relations have the minpages value set to 5.

# SEE ALSO

ingres(1), purge(1), restore(1)

# HISTORY

Originally part of UC Berkeley INGRES 8.9 (1988).

March 28, 2026 | NetBSD 10.1_STABLE