smgr(8) CLIX smgr(8)
NAME
smgr - Initializes the Intergraph graphics windowing environment
SYNOPSIS
/usr/ip32/smgr/smgr
DESCRIPTION
The smgr (Screen Manager) command initializes Intergraph's Environ V-based
graphics windowing environment during a boot or reboot. The smgr command
must be started before other Environ V-based graphics programs will run on
the workstation.
Start-up
At Screen Manager start-up, the Integraph windowing environment
initializes and the screen is fills with a background pattern. Two icons
display on the screen: the Workstation icon, and the Virtual Screen icon
(on single-screen workstations configured for two virtual screens) or the
Primary Screen icon (on dual-screen workstations). These icons are
contained in a window which can be moved and manipulated like any other
window. After a reboot, the icons appear in the location where they were
last placed before the reboot.
Creating the Console Window
Screen Manager first runs the /usr/ip32/smgr/sys_proc command to create
the console window. Since this command is run by root, caution should be
taken when adding additional commands to sys_proc. Full pathnames should
always be used to avoid invoking the wrong command. The sys_proc command
is also run after screens have been reconfigured on single-screen
workstations.
Ideally, /usr/ip32/smgr/sys_proc should contain only the line that invokes
the console so that console output is available before any user has logged
on.
Any commands added to sys_proc should be followed by an ampersand (&) so
that they are executed as background processes. By default, sys_proc
contains only a specification for creating a console.
Establishing a Workstation User
After running sys_proc, Screen Manager runs a command to establish the
``workstation user.'' The workstation user must be established before any
other commands may be started by Screen Manager because the workstation
user determines the user ID and group ID of commands invoked by smgr.
Commands invoked from the Screen Manager pulldown menu, and default
commands specified in /usr/ip32/smgr/def_proc, will run with the
workstation user's corresponding user ID and group ID (which is recorded
2/94 - Intergraph Corporation 1
smgr(8) CLIX smgr(8)
in /etc/passwd).
There are two methods of setting a workstation user:
1. By default, a Workstation User login menu appears at Screen Manager
start-up, requiring a user to log into Screen Manager and become the
workstation user. The menu prompts for a username and password. When
a user keys in a valid username/password combination, the menu is
dismissed and the workstation user is established.
2. The second method allows the user to bypass the Workstation User login
menu. A user can create an /etc/wkstuser file containing a valid
username to be used as the workstation user at each Screen Manager
start-up. The /etc/wkstuser file must be owned by root. With this
method, the workstation user is determined automatically at Screen
Manager start-up; no Workstation User menu will appear to prompt for a
username and password. With this method, the workstation user can be
changed only by invalidating or deleting /etc/wkstuser and restarting
smgr.
If /etc/wkstuser does not exist, is not owned by root, or if the
username specified in the file is invalid, the Workstation User login
menu must be used to establish the workstation user. It is important
to note that use of the /etc/wkstuser file invalidates the security
provided by the Workstation User login menu.
If a home directory does not exist for a login account, a user cannot log
in to that account. The mkdir or addusers command can be used to
establish a home directory for a user account. In addition, a user cannot
log into an account that does not have a password assigned to it. To
assign a password, the user can log into another account and use the
passwd command to set a password for his account.
Logging in to Limited-license Systems
On workstations that were purchased with limited user logins, logging in
to the Workstation User form uses one login. Once the user sitting at the
display has logged in as the Workstation User for that session, he may
create an unlimited number of Local and Shell vterm windows without using
any more login licenses. Each of the following is still counted as one
additional login on limited-license systems:
⊕ A login to the system console.
⊕ A login on the XDM login form to begin a Hybrid X Window session.
⊕ A login via remote network connection (TCP/IP, XNS, etc.).
⊕ A login via serial connection.
Invoking Processes Automatically
2 Intergraph Corporation - 2/94
smgr(8) CLIX smgr(8)
The /usr/ip32/smgr/def_proc and $HOME/.def_proc commands contain system
and workstation user specifications for processes that are to be started
automatically at Screen Manager start-up. Similarly, the
/usr/ip32/smgr/admin_proc file can be used to start processes of an
administrative nature, such as accounting procedures, or to set up
restricted or specialized user environments. A /usr/ip32/smgr/logout_proc
file can be used to stop and close out these administrative procedures
when the workstation user logs out.
The /usr/ip32/smgr/def_proc and /usr/ip32/smgr/admin_proc commands are run
after the workstation user has been established. If the workstation user
is determined by the /etc/wkstuser file, the $HOME/.def_proc file will
also be run at Screen Manager startup. If the workstation user is
determined by logging in through the Workstation User login menu, and the
Execute Default Processes toggle box is checked, $HOME/.def_proc will be
run with each smgr login. If a workstation user exists, both scripts will
be run after reconfiguring screens. Programs invoked by either of the
def_proc commands or the admin_proc command should be followed by an
ampersand (&) so that they are executed as background processes.
Starting Programs from the Pulldown Menu
After the windowing environment has been initialized, the workstation user
established, and default programs started, Screen Manager is ready for
user interaction.
Programs other than the default programs started by the
/usr/ip32/smgr/def_proc and $HOME/.def_proc files may be started from the
Screen Manager pulldown menu. The pulldown menu lists frequently used
programs that can be easily invoked by smgr from the menu. The programs
listed in the pulldown menu are read from the /usr/ip32/smgr/smgr_pd and
$HOME/.smgr_pd files, combining the system selections defined by root with
private selections configured by the workstation user. If a home
directory does not exist for the workstation user, that user cannot start
processes from the pulldown menu.
The Screen Manager pulldown menu may be displayed by clicking the middle
button on the Workstation icon, or by clicking the middle button anywhere
on the background if the background is active. To invoke a process listed
in the pulldown menu, click the left or middle button on the entry. To
dismiss the Screen Manager pulldown menu without making a selection, click
the right button if the cursor is within the menu, or click any button if
the cursor is outside the pulldown menu.
Two special entries, Wkst. User and Configure, appear in the Screen
Manager pulldown menu. Selecting Wkst. User allows a user to change the
workstation user. Selecting Configure allows a user to reconfigure the
Screen Manager pulldown menu, background patterns, and screens.
Changing the Workstation User
2/94 - Intergraph Corporation 3
smgr(8) CLIX smgr(8)
If the Wkst. User entry is selected from the Screen Manager pulldown
menu, the Workstation User login menu returns and prompts for a new
username and password. A successful login to smgr will cause new commands
invoked from the pulldown menu and from /usr/ip32/smgr/def_proc to be run
with the new workstation user's user ID and group ID. Selecting Cancel
causes the workstation user to remain unchanged. Selecting Log Out causes
the workstation user to log out, thus preventing programs from being
invoked from the pulldown menu until a new smgr login occurs.
Reconfiguring the Screen Display and Pulldown
If Configure is selected from the Screen Manager pulldown menu, a
Configure menu displays listing the options that may be configured: Menu,
Background, or Screen(s). The menu for the most recently selected option
will be displayed. If the menu displayed does not feature the option a
user wants to configure, clicking on the desired option with the middle
button displays its corresponding menu. Selecting OK causes the changes
selected in the menu to take effect. Selecting Cancel causes changes to
be ignored.
Selecting the Menu option allows a user to change background activation
and to review or edit the /usr/ip32/smgr/smgr_pd and $HOME/.smgr_pd files.
The background can be made active or inactive by clicking on the
Background Active toggle box. The toggle box contains a check if the
background is currently active. An active background simply provides the
ability to bring up the Screen Manager pulldown menu when and where a
middle button click is made on the background.
To edit or review the Screen Manager pulldown menu entries, first select
the User or System category. If System is selected, the user is editing
or reviewing the /usr/ip32/smgr/smgr_pd files. If User is selected, the
user is editing or reviewing the HOME/.smgr_pd files. Entries may be
added, deleted, or edited only if the user has write privileges for the
selected smgr_pd file.
To select an entry to be viewed or edited, click with the middle button on
the entry in the list. The Menu Name and Process Name keyin fields echo
the selected entry's pulldown menu data (as listed in the smgr_pd file).
To edit the entry, modify the Menu Name and/or Process Name keyin fields
as follows:
To add an entry to the Screen Manager pulldown menu, select where the new
entry should appear in the list by clicking on the list entry with the
middle button. Then, click on the New button and modify the Menu Name and
Process Name keyin fields. The list is limited in length to the number of
entries that can be displayed on the screen in the Screen Manager pulldown
menu.
To delete an entry from the pulldown menu, select the entry in the list to
be deleted by clicking on that list entry with the middle button. Then,
click on the Delete button.
4 Intergraph Corporation - 2/94
smgr(8) CLIX smgr(8)
Changing the Background Pattern
Selecting the Background option on the Configure menu allows the user to
change the screen background pattern. The current background pattern is
highlighted with yellow. To change the pattern, click on the desired
pattern with the middle button. The lower right entry displayed in this
menu is user-configurable. The pattern for this entry is read from the
/usr/ip32/smgr/bgpattern file (see bgpattern(4)).
Configuring Screens on Single-screen Workstations
On single-screen workstations, a Screen(s) option allows the user to
configure the number of virtual screens (either one or two). All
windowing processes must be killed before virtual screens may be
configured. After reconfiguring, the /usr/ip32/smgr/sys_proc script will
be run. If a workstation user has been established, the
/usr/ip32/smgr/def_proc commands will be run as well.
The current screen configuration is highlighted. To change
configurations, click on the desired configuration with the middle button.
Setting the Virtual or Primary Screen
The Virtual Screen (single-screen workstations) and Primary Screen (dual-
screen workstations) icons indicate on which screen a user wants programs
to be started. The active screen may be swapped by clicking on the
Primary or Virtual Screen icon.
On a single-screen workstation, the Virtual Screen icon (showing one block
behind another) is displayed only if the workstation is configured for two
virtual screens. The Virtual Screen icon indicates which virtual screen
(front or back) a user is viewing.
On a dual-screen workstation, the Primary Screen icon is an arrow pointing
to the screen (left or right) on which programs will be started.
FILES
/usr/ip32/smgr/bgpattern Specifies the pattern to be displayed in the
user-configurable entry in the Configure
Background Pattern menu.
/usr/ip32/smgr/smgr_vlt Specifies the foreground and background colors
of the Screen Manager background.
/usr/ip32/smgr/sys_proc Specifies commands that must be executed before
a workstation user is determined.
/etc/wkstuser Specifies a username to be used as the
workstation user at Screen Manager start-up.
2/94 - Intergraph Corporation 5
smgr(8) CLIX smgr(8)
/usr/ip32/smgr/smgr_pd Specifies commands that most users logged into
a workstation desire in the Screen Manager
pulldown menu.
$HOME/.smgr_pd Specifies commands that the current workstation
user desires in the Screen Manager pulldown
menu.
/usr/ip32/smgr/def_proc Specifies programs that are to be started
automatically at Screen Manager start-up.
$HOME/.def_proc Specifies programs that the current workstation
user wants to have started automatically at
Screen Manager start-up.
/usr/ip32/smgr/admin_proc Specifies programs of an administrative nature
that are to be started when a user logs in to
the Workstation User login form.
/usr/ip32/smgr/logout_proc Specifies programs, usually of an
administrative nature, to be closed out, or
stopped, when the workstation user logs out.
CAUTIONS
Using an /etc/wkstuser file to establish the workstation user invalidates
the security advantage provided by the Workstation User login form.
RELATED INFORMATION
Commands: smgrutil(8), confirm(1)
Files: bgpattern(4), smgr_vlt(4)
Intergraph System User's Guide, Intergraph System and Network
Administrator's Guide
6 Intergraph Corporation - 2/94