NAME

satools − Solbourne system administration tools

SYNOPSIS

/usr/etc/satools [ -demo ] [ -list ] [ tool_name ]

DESCRIPTION

satools is the Solbourne system administration tools.  These tools are built on pds(8).  satools allows for easy maintenance of such tasks as user, group, and network account maintenance, in addition to configuring modems and diskless clients. 

Invoking satools is done at the command line by entering: /usr/etc/satools.  satools only runs on a Solbourne (Sun 4-compatible) system. 

If the user is not root, they are informed that they are in “demo” mode.  The user can suppress this message by giving the -demo option.  When satools starts, the user is in the main menu.  They can bypass this menu by giving the name of the tool they wish to execute, and a list of tool names is available by executing satools with the -list option. 

If a tool name is given, satools exits when the tool is exited. 

The instructions in the remainder of this description, applies to any screen, including the main menu. 

Moving around the screen is done by using the Tab and Esc keys.  A Tab moves to the next active place on the screen, moving left to right and top to bottom.  An Esc moves in the opposite direction.  The “current item” is the one in which the cursor rests, so the user always knows where their input is going. 

When the current item looks like (text), the user is on a button.  If the Space, bar is pressed, the button is “clicked,” and the tool performs the function associated with that button.  For example, in the User Account Maintenance tool, the (Save) button saves the data the user has entered as a user account.  If Return is pressed, the button is clicked and the user moves to the next active place, as though they had also hit a Tab. 

The current item may appears as a [X] or [ ], which indicates a check box.  If the Space is pressed, the X changes to a space, or vice versa.  This acts like flipping a switch.  For example, in the Modem Setup tool, the check box marked “Notify the system of changes” determines whether or not the tool notifies the system immediately that a change has been made.  If the user presses a Return, the check box is flipped and they move to the next active position. 

When the current item appears as a (∗) or ( ), it indicates a radio button.  Radio buttons come in clusters, and only one button in a cluster can have an ∗ inside.  If the button looks like (∗), there is nothing that can be done to it.  If the button appears blank, like ( ), and the user presses the Space, that button is turned on, and the button that was on in that cluster is turned off.  For example, in the Modem Setup tool, the “Line” section contains a radio button cluster for /dev/ttya, /dev/ttyb, and Other.  By default, the button marked /dev/ttya is on, but by moving to one of the other two buttons in the cluster and clicking on one of those, the user changes the choice of which line to use.  If the user presses the Return, the current radio button is turned on and they move to the next active position. 

When the current item is blank or has text in it, the user is in a text field.  Text fields are more complex than the other items.  Normally, any text entered is inserted at the current place.  The erase character erases the character to the left.  The characters Control-K (^K) erases from the current position to the end of the field.  The kill character erases from the current position to the beginning of the field.  A Control-F (^F) moves right one space, and Control-B (^B) moves left one space. Any other control characters are replaced by question mark (?).  A Tab or Return send the data to the tool and moves to the next field.  An Esc sends the data and moves to the previous field.  If the interface beeps, this means that either the operation requested could not be done (such as backspacing past the beginning of the field) or that the data is invalid, meaning that it is either too long or does not match the regular expression attached to the field.  If the user is confused by a beep, read the help for the appropriate tool to find out what values are valid. 

When the screen is redrawn with a title at the top, a line containing “Page n of n,” some text, and some buttons on the bottom line, the user is in the file pager.  The file pager is used to display the contents of a file.  If there is only one page, the only button is (Quit), which when clicked causes the pager to exit.  The (Next) and (Previous) buttons are shown when they are reasonable, and are used to page through the file data.  The buttons works as described in the button description above.  For example, in any tool, clicking the (Help) button brings up the file pager on the help file for that tool. 

Sometimes, as an initial condition or as the result of some action, an item becomes “locked,” meaning it can not be used.  For example, when the User Account Maintenance tool starts, the only items that aren’t locked are the Username: text field and the (Quit) and (Help) buttons.  As soon as a username has been entered, other buttons and fields become active.  There is no way in a general terminal interface to indicate locked items, so the only indication the user has that an item is locked is that when the user tries to move onto the item they bypass it instead.  In other words, the user may only visit unlocked items. 

OPTIONS

-demo If the user is root, demo mode is turned on which tells satools not to modify any files or execute any system commands.  If the user is not root, demo suppresses the message that says demo mode is being run. 

-list List the set of tool_name and supply a set of descriptions for each. 

tool_name
Is one of the available interfaces for satools.  These include:

user User Accounting

group Group Accounting

netgroup
Network Group Accounting

modem Add Modem Line

server Configure Diskless Client Server

client Install Diskless Client

network Host Information

mail Configure Subsidiary for sendmail(8) Host

aliases Maintain mail(1) Alias List

names Domain Name and Host Name Accounting

EXAMPLE

An example use of satools is shown below.  # /usr/etc/satools -demo user The above example invokes the interface for doing user account maintenance. When that tool is exited, control is returned to the shell.

An example .pdsrc file follows:

page       8
pagex      10
title      on
icon       on
moveptr    off

page is the number of lines to display (e.g., from help file) on curses display.  pagex is the same as page, except for an X display. title will change or not change the title when “decorate” function called. icon will change or not change the icon when “decorate” function called. moveptr moves the mouse pointer to the next field automatically.

FILES

$HOME/.pdsrc file to customize the user’s administration interface input mappings

SEE ALSO

pds(1)

Solbourne System Administration Tools

COPYRIGHT

Copyright, Solbourne Computer, Inc. 

AUTHOR

David Elliott and Kuntal Rawal, Solbourne Computer, Inc. 

Solbourne Computer, Inc.  —  15 November 1989