Release Date: 1 February 2008
Namethorfilters - Filter programs for Thor/Merlin management
Unix Synopsisthorfilters - "filter" programs for Thor/Merlin management
Description"Thorfilters" is a set of programs that perform Thor/Merlin database-management tasks. Their capabilities are similar to those provided by sthorman, however, some tasks are better done with sthorman and some with thorfilters programs.
The title "thorfilters" is from the UNIX tradition of "filter" programs (such as sed(1), grep(1) and sort(1)), each of which performs a single text- processing task. UNIX filter programs are treated as "building blocks", and are typically "piped together" to perform complex tasks.
This building-block approach is the basis for thorfilters. Each of these programs performs one task, such as creating a database (thormake), loading data into a database (thorload), or listing available databases (thorls). By combining these building blocks, you can perform complex Thor- and Merlin-database management tasks.
Below is a very brief summary of each thorfilter. The following "chapters" describe each "filter" in detail.
dayevict ...... evict a user from Thor or MerlinAll thorfilters programs (and most other Daylight programs that use Thor and Merlin databases) use a single syntax for naming servers and databases.
The complete syntax is in database(5). Briefly, it is like this:
database ... name of the database being openedMost of the fields in the specification are optional; defaults are automatically supplied for those that you leave out.
If the database does not include passwords for the server and/or the database, you are prompted for them. If a database and/or server doesn't require a password, you indicate this by putting in the % with no password after it. For example:
mydb@zeus ...... Ask for the database and server passwordNote that you will be prompted for passwords even if you redirect input and output -- the Thorfilters programs use a special file to prompt you that goes to your terminal even when I/O is redirected to pipes or files. (See the option SECURE_PASSWORDS, below.)
OptionsThere following options are common to all thorfilter programs:
Normally, if passwords are entered on the command line (e.g. "mydb%mypass"), a thorfilter program will exit immediately. This is to discourage password discovery via programs, such as ps(1), that show the complete command line used to invoke a program. If SECURE_PASSWORDS is set to FALSE, passwords can be entered on the command line. See the Help Widget's "databasename" topic for more details.-THOR_IPC_SERVICE service
Names the default service (see /etc/services) or "port" of the Thor server or Merlin server, respectively. Defaults are "thor" "merlin" for Thor and Merlin programs, respectively. Note that these options are ignored if a server's name includes the service (e.g. "crawdad:thor2").-SERVER_TIMEOUT nnn
Sets a timeout value in seconds for any connection attempts. After 'nnn' seconds, all connection attempts time out and fail with a message. This prevents programs from blocking indefinitely under some circumstances. The default value is 60 seconds.ERROR: Can't connect to host: crawdad (dy_ipc_connect)
The specified server couldn't be reached. Either it is not running, is using a different service, or is not reachable via your network.ERROR: login failed - invalid user/password or host (ipc_login)
The username/password you used are not correct, or the server is using the "restricted hosts" mode of security (see sthorman) and your computer is not on the list of authorized computers.
One or more of the options files couldn't be read. Usually due to an incorrect definition of the environment variables DY_ROOT or DY_OPTIONS.SECURE_PASSWORDS is TRUE ... server%password specification not allowed
You entered a password on the command line without setting the option SECURE_PASSWORDS to FALSE.
Related Topicsdayevict(1) daymessage(1) merlindbping(1) merlinload(1) merlinls(1) merlinping(1) merlinwho(1) thorchange(1) thorcrunch(1) thordbping(1) thordelete(1) thordestroy(1) thordiff(1) thordump(1) thorlist(1) thorload(1) thorlookup(1) thorls(1) thormake(1) thorping(1) thorwho(1)
Daylight Theory Manual, Daylight System Administration Manual
$DY_ROOT/contrib/src/thor - several example shell scripts for Thor database administration.