dtappgather man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



     dtappgather(1)    UNIX System V (1 August 1995)	dtappgather(1)

     NAME
	  dtappgather - gather application files for presentation by
	  the Application Manager

     SYNOPSIS
	  [ -r ]

     DESCRIPTION
	  The Application Manager presents personal, system, and
	  factory applications in an easy-to-access window.  The
	  Application Manager is implemented as a special File Manager
	  view of a subdirectory that is built on a per-user, per-
	  session basis.  The dtappgather utility is responsible for
	  creating and refreshing the user's Application Manager
	  subdirectory.

	  The dtappgather utility is run at login and whenever the
	  user invokes the ReloadApps action.  The user's individual
	  subdirectory for the Application Manager,
	  /var/dt/appconfig/appmanager/$DTUSERSESSION, is opened when
	  the user presses the Application Manager control on the
	  Front Panel.

	  The sequence of events is as follows:

	     o	     When the user logs in, the Xsession script
		     sources in the Xsession.d script that sets the
		     DTUSERSESSION environment variable.

	     o	     Xsession then invokes the dtsearchpath utility to
		     set the DTAPPSEARCHPATH environment variable.

	     o	     After dtsearchpath returns with the
		     DTAPPSEARCHPATH assembled, the Xsession script
		     calls dtappgather.

	     o	     As its main function, dtappgather traverses the
		     DTAPPSEARCHPATH, examining each possible source
		     of applications and, where there are existing
		     source subdirectories, creates symbolic links
		     between the source and the user's DTUSERSESSION
		     subdirectory.

	     o	     Finally, dtappgather turns off write permissions
		     on the resulting subdirectory to ensure its
		     integrity.

		     A similar sequence occurs when the user double-
		     clicks the ReloadApps action after logging in.

		     Although the value of the DTAPPSEARCHPATH can be
		     modified in a local shell, the Application

     Page 1					      (printed 9/3/04)

     dtappgather(1)    UNIX System V (1 August 1995)	dtappgather(1)

		     Manager view based on its value is not functional
		     until you log out and log back in.	 Since this
		     can be a tedious venture, you can verify the
		     Application Manager view by executing
		     dtsearchpath(1) and dtappgather in the local
		     shell.  For example, to add host trout as a
		     system-wide application server, set the
		     dtsearchpath(1) input environment variable,
		     DTSPSYSAPPHOSTS:

		     DTSPSYSAPPHOSTS=trout:

		     Then, execute dtsearchpath(1) to update the
		     DTAPPSEARCHPATH environment variable.

		     eval `dtsearchpath`

		     Finally, gather the new applications by executing
		     dtappgather.  The Application Manager will show
		     the new application groups but will not be
		     functional.

     OPTIONS
	  The -r option causes dtappgather to retain the previous
	  contents of the Application Manager, although discarding
	  broken links.	 At login, dtappgather destroys the user's
	  previous DTUSERSESSION subdirectory before creating a new
	  one.	At ReloadApps time, the -r option is used to minimize
	  visual disruption of any opened Application Manager views.

     RETURN VALUES
	  The command always returns 0 (zero) for successful
	  completion.

     ENVIRONMENT
	     DTAPPSEARCHPATH
			    Set by the dtsearchpath(1) utility.
			    DTAPPSEARCHPATH controls the places where
			    dtappgather will gather applications.  The
			    default locations consist of
			    $HOME/.dt/appmanager (for end users),
			    /etc/dt/appconfig/appmanager/$LANG (for
			    system administrators), and
			    /usr/dt/appconfig/appmanager/$LANG (for
			    factory applications).

	     DTUSERSESSION  Controls the location of the end user's
			    subdirectory where the Application Manager
			    will be rooted.  The subdirectory name
			    includes both the user's $LOGNAME and
			    $DISPLAY in order to ensure the user's
			    view of the Application Manager remains

     Page 2					      (printed 9/3/04)

     dtappgather(1)    UNIX System V (1 August 1995)	dtappgather(1)

			    consistent across sessions.

     LOCALES
	  When searching for system administrator and factory default
	  Application Manager files, dtappgather always uses a value
	  of $LANG equal to C.	When the user picks a language at
	  login, the corresponding $LANG subdirectories are searched.
	  If multiple $LANG subdirectories exist in
	  /etc/dt/appconfig/appmanager, all $LANG subdirectories will
	  appear in the Application Manager; however, if multiple
	  $LANG subdirectories exist in /usr/dt/appconfig/appmanager
	  then the language-specific subdirectory based on the current
	  value of $LANG is chosen instead of the C subdirectory.

	  Regardless of locale, all the action files that exist under
	  the user's $HOME/.dt/appmanager subdirectory will be
	  symbolically linked to the user's Application Manager
	  subdirectory.

     FILES
	     /usr/dt/bin/Xsession
			    Among its tasks at login, the Xsession
			    script invokes dtsearchpath(1), and then
			    dtappgather.

	     /var/dt/appconfig/appmanager/$DTUSERSESSION
			    This subdirectory is where dtappgather
			    assembles the Application Manager view for
			    the particular user and CDE session.

     NOTES
	  In the case of multiple search locations having the same
	  name, dtappgather picks only the first and discards the
	  rest.	 For example, if the system administrator sets
	  DTSPSYSAPPHOSTS=tuna:,trout:
	  and if both hosts, tuna and trout, have an
	  /etc/dt/appconfig/appmanager/C/Editors folder, then only the
	  Editors folder from tuna (the first host) will appear in the
	  user's Application Manager.

	  After building the user's DTUSERSESSION, dtappgather turns
	  off write permissions on that subdirectory to disallow
	  alteration by the end user.  Although the end user can
	  resize the window and rearrange the icons within the window,
	  the Application Manager is intended to be a read-only source
	  of local and networked applications.

     SEE ALSO
	  dtappintegrate(1), dtsearchpath(1).

     Page 3					      (printed 9/3/04)

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net