1rhsm-icon(8) RHSM Desktop Icon rhsm-icon(8)
2
6 rhsm-icon - Periodically checks installed products against active sub‐
7 scriptions to check their status.
8
11 rhsm-icon [--check-period] [--force-icon=warning|expired|partial]
12 [--check-immediately]
13
16 Red Hat provides content updates and support by issuing subscriptions
17 for its products. These subscriptions are applied to systems (machines)
18 and apply to the installed software products.
19 On graphical X systems (systems with a GUI interface), a product status
22 daemon runs every 4 hours to check the currently installed software
23 against the applied subscriptions. If software is installed without a
24 valid and applied subscription (such as a subscription expires or no
25 subscription is available for the product), then the daemon triggers an
26 icon and warning message to display in the notification area of the
27 menu.
28 rhsm-icon
31 only runs on graphical (X-based) systems. Servers which do not have a
32 GUI interface do not run or require the rhsm-icon daemon.
33
36 -c, --check-period
37 Sets the interval to use between checks for the product sub‐
38 scription status. The value is in seconds and the default is one
39 day.
40 -f, --force-icon=TYPE
43 Manually displays the given type of icon in the start menu. The
44 TYPE can be warning, expired, or partial and uses a different
45 icon for each type of message.
46 --i, --check-immediately
49 Runs the status check process immediately when the command is
50 invoked. Otherwise, there is a four (4) minute delay before run‐
51 ning the initial check.
52 -d, --debug
55 Shows debug messages for the daemon.
56
59 There are two reasons to invoke rhsm-icon manually:
60 * To run the daemon on a new schedule (immediately or with a
63 different frequency)
64 * To view the status icons or messages regardless of the state
67 of the machine
68 Since X runs the daemon automatically and on schedule, it is not neces‐
71 sary to launch the subscription status daemon manually. The rhsm-icon
72 command can change this schedule. For example:
73 rhsm-icon --check-period 120
74 Administrators can also run rhsm-icon to view any immediate changes to
77 the subscription status of the system. Using the --check-immediately
78 option runs the check at the time the command is run; otherwise, run‐
79 ning rhsm-icon has a four-minute delay before running the status check.
80 rhsm-icon --check-immediately
82 If you just want to know what the different subscription status mes‐
85 sages look like, then use the --force-icon option. (Also use the
86 --check-immediately option, or the scan will take the standard four
87 minutes to run and display the icon.)
88 rhsm-icon --force-icon=warning --check-immediately
90 rhsm-icon --force-icon=expired --check-immediately
91 rhsm-icon --force-icon=partial --check-immediately
92
95 This daemon is part of Red Hat Subscription Manager. To file bugs
96 against this daemon, go to https://bugzilla.redhat.com, and select Red
97 Hat > Red Hat Enterprise Linux > subscription-manager.
98
102 Deon Lackey, <dlackey@redhat.com>, and James Bowes, <jbowes@red‐
103 hat.com>. rhsm-icon was written by James Bowes.
104
107 Copyright (c) 2010-2012 Red Hat, Inc. This is licensed under the GNU
108 General Public License, version 2 (GPLv2). A copy of this license is
109 available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
110 rhsm-icon(8)