StartMonitor(1M)                                 StartMonitor(1M)



NAME
     StartMonitor - displays a progress bar during the A/UX  boot
     sequence

SYNOPSIS
     StartMonitor

DESCRIPTION
     StartMonitor displays and updates a progress bar to show the
     progress being made during the last few phases of the A/UX
     boot sequence.  It also offers a Cancel button, but the
     button is not enabled at this stage in the A/UX boot
     process. Before StartMonitor takes over responsibility for
     displaying and updating the progress bar, the A/UX Startup
     application performs a similar function up to the point at
     which the A/UX kernel is given complete control of the
     system.

     (The kernel is the first program that runs in place of the
     Macintosh Operating System and it immediately launches init.
     The init program completes the booting process by running
     the programs specified in /etc/inittab.  The macsysinit
     program is one of the first programs specified in
     /etc/inittab, and it in turn invokes startmac, treating
     StartMonitor as if it were the Finder application. When init
     is nearly finished initializing all the processes associated
     with the normal run state for A/UX, a startmsg line in
     /etc/inittab sends a signal to StartMonitor to quit. Before
     /etc/loginrc can invoke Login or getty to obtain a user
     login name, init waits for confirmation that StartMonitor
     really has exited.  As it exits, StartMonitor cleanly shuts
     down the virtual Macintosh session that had supported it as
     well as a special CommandShell process that enables users to
     provide keyboard input in a console window during A/UX
     initialization, should it become necessary.)

     The StartMonitor program receives messages by means of a
     System V message queue from other processes (such as
     startmsg) involved in booting the system.  These messages
     indicate the total number of boot phases, the current boot
     phase, the percentage of that phase that has been completed,
     the ID of messages to be displayed, and the strings to
     substitute for parameters in the message strings.  The
     message strings are stored in the string list in the
     resource file

        /mac/sys/Startup System Folder/%StartMonitor

     The message ID number is its position in the string list in
     the resource file.





January 1992                                                    1

StartMonitor(1M)                                 StartMonitor(1M)



     The StartMonitor program exits when it receives a quit
     message.

     Shell scripts involved in booting invoke startmsg with
     appropriate arguments to send messages. The fsck program
     sends messages directly to StartMonitor.  After the root
     file system has been checked, applications that need to send
     messages to StartMonitor are able to invoke startmsg to help
     do so.  If many messages need to be sent, the application
     could create a pipe to startmsg and write startmsg argument
     strings into the pipe.

FILES
     /mac/sys/Startup System Folder/StartMonitor
          Executable file
     /mac/sys/Startup System Folder/%StartMonitor
          Resource fork file
     /usr/include/apple/startmsg.h
          Source code file describing message structures
SEE ALSO
     brc(1M), startmsg(1M)


































2                                                    January 1992