813078 – Document use of IRQBALANCE_BANNED_INTERRUPTS and give examples for it and for IRQBALANCE_BANNED_CPUS

RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 813078 - Document use of IRQBALANCE_BANNED_INTERRUPTS and give examples for it and for IRQBALANCE_BANNED_CPUS

Summary: Document use of IRQBALANCE_BANNED_INTERRUPTS and give examples for it and for...

Keywords:
Status:	CLOSED ERRATA
Alias:	None
Product:	Red Hat Enterprise Linux 6
Classification:	Red Hat
Component:	irqbalance
Sub Component:
Version:	6.4
Hardware:	All
OS:	Linux
Priority:	unspecified
Severity:	low
Target Milestone:	rc
Target Release:	---
Assignee:	Petr Holasek
QA Contact:	John Brier
Docs Contact:
URL:
Whiteboard:
Depends On:
Blocks:	782183 840683 852981 1020633 1827319
TreeView+	depends on / blocked

Reported:	2012-04-16 20:10 UTC by nayfield
Modified:	2020-04-23 16:08 UTC (History)
CC List:	9 users (show)
Fixed In Version:	irqbalance-1.0.4-3
Doc Type:	Bug Fix
Doc Text:	The irqbalance(1) man page does not contain documentation for the IRQBALANCE_BANNED_CPUS and IRQBALANCE_BANNED_INTERRUPTS environment variables. The following documentation will be added to this man page in a future release: IRQBALANCE_BANNED_CPUS Provides a mask of cpus which irqbalance should ignore and never assign interrupts to. This is a hex mask without the leading '0x', on systems with large numbers of processors each group of eight hex digits is separated by a comma ','. i.e. `export IRQBALANCE_BANNED_CPUS=fc0` would prevent irqbalance from assigning irqs to the 7th-12th cpus (cpu6-cpu11) or `export IRQBALANCE_BANNED_CPUS=ff000000,00000001` would prevent irqbalance from assigning irqs to the 1st (cpu0) and 57th-64th cpus (cpu56-cpu63). IRQBALANCE_BANNED_INTERRUPTS Space separated list of integer irq's which irqbalance should ignore and never change the affinity of. i.e. export IRQBALANCE_BANNED_INTERRUPTS="205 217 225"
Clone Of:	479856
Clones:	852981 1020633 (view as bug list)
Environment:
Last Closed:	2013-02-21 09:49:18 UTC
Target Upstream Version:
Embargoed:

Attachments	(Terms of Use)

Links
System	ID	Private	Priority	Status	Summary	Last Updated
Red Hat Product Errata	RHBA-2013:0367	0	normal	SHIPPED_LIVE	irqbalance bug fix and enhancement update	2013-02-20 20:52:47 UTC

Description nayfield 2012-04-16 20:10:56 UTC

The documentation change from the RHEL5 errata wasn't upstreamed.

Doc regression ;)



+++ This bug was initially created as a clone of Bug #479856 +++

Created attachment 328890 [details]
Proposed patch for irqbalance.1 man page.

Description of problem:
The man page for irqbalance does not include the environment variable IRQBALANCE_BANNED_INTERRUPTS.

Additionally examples for utilizing IRQBALANCE_BANNED_INTERRUPTS and IRQBALANCE_BANNED_CPUS would be helpful

Version-Release number of selected component (if applicable):
irqbalance-0.55-10

--- Additional comment from nhorman on 2009-01-13 12:42:06 EST ---

Fine, although the example isn't complete, its space delimited at every 32 bits so the example should probably show something like:
IRQBALANCE_BANNED_INTERRUPTS="00000000 0000000c"
Just so that people understand how it works for largesmp systems

--- Additional comment from kasmith on 2009-01-15 17:57:13 EST ---

Created attachment 329148 [details]
Better examples of how to set the env vars.

--- Additional comment from errata-xmlrpc on 2009-09-02 05:18:18 EDT ---

An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2009-1265.html

Comment 2 RHEL Program Management 2012-05-03 05:18:27 UTC

Since RHEL 6.3 External Beta has begun, and this bug remains
unresolved, it has been rejected as it is not proposed as
exception or blocker.

Red Hat invites you to ask your support representative to
propose this request, if appropriate and relevant, in the
next release of Red Hat Enterprise Linux.

Comment 4 Martin Prpič 2012-06-01 10:51:44 UTC

    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
The irqbalance(1) man page does not contain documentation for the IRQBALANCE_BANNED_CPUS and IRQBALANCE_BANNED_INTERRUPTS environment variables. The following documentation will be added to this man page in a future release:

    IRQBALANCE_BANNED_CPUS

        Provides a mask of cpus which irqbalance should ignore and never assign interrupts to. This is a hex mask without the leading '0x', on systems with large numbers of processors each group of eight hex digits is sepearated ba a comma ','. i.e. `export IRQBALANCE_BANNED_CPUS=fc0` would prevent irqbalance from assigning irqs to the 7th-12th cpus (cpu6-cpu11) or `export IRQBALANCE_BANNED_CPUS=ff000000,00000001` would prevent irqbalance from assigning irqs to the 1st (cpu0) and 57th-64th cpus (cpu56-cpu63).

    IRQBALANCE_BANNED_INTERRUPTS

        Space seperated list of integer irq's which irqbalance should ignore and never change the affinity of.  i.e.

        export IRQBALANCE_BANNED_INTERRUPTS="205 217 225"

Comment 8 Laura Bailey 2012-08-02 07:37:56 UTC

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -2,10 +2,10 @@
 
     IRQBALANCE_BANNED_CPUS
 
-        Provides a mask of cpus which irqbalance should ignore and never assign interrupts to. This is a hex mask without the leading '0x', on systems with large numbers of processors each group of eight hex digits is sepearated ba a comma ','. i.e. `export IRQBALANCE_BANNED_CPUS=fc0` would prevent irqbalance from assigning irqs to the 7th-12th cpus (cpu6-cpu11) or `export IRQBALANCE_BANNED_CPUS=ff000000,00000001` would prevent irqbalance from assigning irqs to the 1st (cpu0) and 57th-64th cpus (cpu56-cpu63).
+        Provides a mask of cpus which irqbalance should ignore and never assign interrupts to. This is a hex mask without the leading '0x', on systems with large numbers of processors each group of eight hex digits is separated by a comma ','. i.e. `export IRQBALANCE_BANNED_CPUS=fc0` would prevent irqbalance from assigning irqs to the 7th-12th cpus (cpu6-cpu11) or `export IRQBALANCE_BANNED_CPUS=ff000000,00000001` would prevent irqbalance from assigning irqs to the 1st (cpu0) and 57th-64th cpus (cpu56-cpu63).
 
     IRQBALANCE_BANNED_INTERRUPTS
 
-        Space seperated list of integer irq's which irqbalance should ignore and never change the affinity of.  i.e.
+        Space separated list of integer irq's which irqbalance should ignore and never change the affinity of.  i.e.
 
         export IRQBALANCE_BANNED_INTERRUPTS="205 217 225"

Comment 11 John Brier 2012-11-13 16:40:27 UTC

Note for RHEL 6.3 irqbalance I actually do see the IRQBALANCE_BANNED_CPUS environment variable mentioned, there is just no example:

In irqbalance-0.55-34.el6.x86_64 I see

       IRQBALANCE_BANNED_CPUS
              Provides a mask of cpus which irqbalance should ignore and never assign interrupts to

In irqbalance-1.0.4-3.el6.x86_64.rpm I see 
       IRQBALANCE_BANNED_CPUS
              Provides a mask of cpus which irqbalance should ignore and never
              assign  interrupts  to.  This  is a hex mask without the leading
              ’0x’, on systems with large numbers of processors each group  of
              eight  hex  digits  is  separated  by  a comma ’,’. i.e. ‘export
              IRQBALANCE_BANNED_CPUS=fc0‘  would   prevent   irqbalance   from
              assigning  irqs  to  the  7th-12th  cpus (cpu6-cpu11) or ‘export
              IRQBALANCE_BANNED_CPUS=ff000000,00000001‘ would prevent  irqbal-
              ance  from  assigning  irqs to the 1st (cpu0) and 57th-64th cpus
              (cpu56-cpu63).


as Petr mentioned in comment 9 there is no mention of IRQBALANCE_BANNED_INTERRUPTS env variable

also the misspelled "sepearated" that Laura mentioned in comment 8 is spelled correctly in the Errata release.

Looks good to me.

Comment 13 errata-xmlrpc 2013-02-21 09:49:18 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2013-0367.html

Note You need to log in before you can comment on or make changes to this bug.