Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rhsm-icon(8) [centos man page]

rhsm-icon(8)						    Subscription Status Daemon						      rhsm-icon(8)

NAME

       rhsm-icon - Periodically checks installed products against active subscriptions to check their status.

SYNOPSIS

       rhsm-icon [--check-period] [--force-icon=warning|expired|partial] [--check-immediately]

DESCRIPTION

       Red  Hat  provides  content  updates  and  support  by  issuing	subscriptions for its products. These subscriptions are applied to systems
       (machines) and apply to the installed software products.

       On graphical X systems (systems with a GUI interface), a product status daemon runs every 4 hours to check the currently installed software
       against	the applied subscriptions. If software is installed without a valid and applied subscription (such as a subscription expires or no
       subscription is available for the product), then the daemon triggers an icon and warning message to display in the notification area of the
       menu.

       rhsm-icon
	only runs on graphical (X-based) systems. Servers which do not have a GUI interface do not run or require the rhsm-icon daemon.

OPTIONS

       -c, --check-period
	      Sets the interval to use between checks for the product subscription status. The value is in seconds.

       -f, --force-icon=TYPE
	      Manually	displays  the given type of icon in the start menu. The TYPE can be warning, expired, or partial and uses a different icon
	      for each type of message.

       --i, --check-immediately
	      Runs the status check process immediately when the command is invoked. Otherwise, there is a four (4) minute  delay  before  running
	      the check.

       -d, --debug
	      Shows debug messages for the daemon.

USAGE

       There are two reasons to invoke rhsm-icon manually:

	      * To run the daemon on a new schedule (immediately or with a different frequency)

	      * To view the status icons or messages regardless of the state of the machine

       Since X runs the daemon automatically and on schedule, it is not necessary to launch the subscription status daemon manually. The rhsm-icon
       command can change this schedule. For example:
       rhsm-icon --check-period 120

       Administrators can also run rhsm-icon to view any immediate changes to the subscription status of the system. Using the --check-immediately
       option runs the check at the time the command is run; otherwise, running rhsm-icon has a four-minute delay before running the status check.

       rhsm-icon --check-immediately

       If  you	just  want  to	know  what  the  different subscription status messages look like, then use the --force-icon option. (Also use the
       --check-immediately option, or the scan will take the standard four minutes to run and display the icon.)

       rhsm-icon --force-icon=warning --check-immediately
       rhsm-icon --force-icon=expired --check-immediately
       rhsm-icon --force-icon=partial --check-immediately

BUGS

       This daemon is part of Red Hat Subscription Manager. To file bugs against this daemon, go to https://bugzilla.redhat.com,  and  select  Red
       Hat > Red Hat Enterprise Linux > subscription-manager.

AUTHORS

       Deon Lackey, <dlackey@redhat.com>, and James Bowes, <jbowes@redhat.com>. rhsm-icon was written by James Bowes.

COPYRIGHT

       Copyright  (c)  2010-2012 Red Hat, Inc. This is licensed under the GNU General Public License, version 2 (GPLv2). A copy of this license is
       available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.

version 1.3							 December 12, 2012						      rhsm-icon(8)

Check Out this Related Man Page

WM-ICONS-CONFIG(1)					      General Commands Manual						WM-ICONS-CONFIG(1)

NAME

       wm-icons-config - show and set configuration for wm-icons

SYNOPSIS

       wm-icons-config [options] NAME [ICON_SET] ...

DESCRIPTION

       This  show  wm-icons  package  configuration, and the list of installed icon sets. It also is used to set aliases to icon-sets in system or
       user space. In the synopsis above, NAME is icon alias name, ICON_SET is icon set directory  (for  example:  mini  16x16-default).  If  NAME
       already	exists as an alias, it is not overwritten, unless the --force option is given. Explicit NAMEs override --defaults.  Just the alias
       names are given for --which and --remove options.

OPTIONS

   Informational options: display info and exit
       --help Print a short usage message

       --version
	      Show version number and exit

       --inst-dir
	      Show wm-icons installed icon directory and exit

       --user-dir
	      Show wm-icons user icon directory and exit

       --show-defaults
	      Show default aliases and exit

       --show-aliases
	      Show the aliases currently present. One of --global, --personal, --user-dir must be given

       --show-sets
	      Show a list of installed icon sets

   Directory selection options: precisely one of these must be given
       --global
	      Set up global (system-wide) links in the base dir

       --personal
	      Set up personal links in ~/.wm-icons

       --user-dir=USER_DIR
	      Set up links in USER_DIR

   Choice of links: at least one of these must be given
       --defaults
	      Set up default aliases, as shown by --show-defaults

   Extra options
       --remove
	      Remove the symlinks rather than creating them, return (0, 1)

       --which
	      Show the icon set for the given alias(es), return (0, 1)

       --quiet
	      Do not output results of alias manipulating to stdout

       --force
	      Force overwriting of existing symlinks

BUGS

       None known.

AUTHORS

       Mikhael Goikhman <migo (at) cpan.org> and others (see file AUTHORS).

       This manual page was initially written by Manoj Srivastava <srivasta@debian.org>, for the Debian GNU/Linux system.

								    09-Apr-2006 						WM-ICONS-CONFIG(1)
Man Page