IBM Support

IV67514: DOC : DOG THREADS CREATION CLARIFICATION APPLIES TO AIX 7100-03

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Dosumentation for no option:ndogthreads states:
    A value of 0 sets it to default ie dog threads equal to
    the number of CPUs. Max value is 1024.
    
    This is not correct. The maximum number of dog threads is
    currently capped at 256 even if more cpus are available.
    --------------------------------------------------------
    no -h ndogthreads
    Help for tunable ndogthreads:
    Purpose:
    Specifies the number of dog threads that are used during
    hashing.
    
    Values:
            Default: 0
            Range: 0 - 1024
            Type: Dynamic
            Unit: numeric
    Tuning:
    This option is valid only if dog threads are enabled for
    an interface. A value of 0 sets it to default ie dog
    threads equal to the number of CPUs. Max value is 1024.
    The minimum of tunable value and the number of cpus is
    taken as the number of dog threads during hashing.
    

Local fix

  • The number of dog threads is determined at system
    initialization time as the smaller of "number of cpus"
    or
    256.
    
    ndogthreads determines how many of these threads are
    active. The incoming packets are hashed across the
    number of active threads based on ipaddress and port
    (if available) unless they are raw. Raw packets are
    mapped to dog 0.
    
    Note that a single connection will utilize a single dog
    thread.
    

Problem summary

  • Help message of 'ndogthreads' no option is not clear on the
    number of dog threads created.
    

Problem conclusion

  • Modified the help message of 'ndogthreads' to state the purpose
    of this tunable and how the number of dog threads created is
    calculated.
    

Temporary fix

Comments

  • 6100-08 - use AIX APAR IV61559
    6100-09 - use AIX APAR IV67460
    7100-02 - use AIX APAR IV70190
    7100-03 - use AIX APAR IV67514
    

APAR Information

  • APAR number

    IV67514

  • Reported component name

    AIX V7.1

  • Reported component ID

    5765H4000

  • Reported release

    710

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Submitted date

    2014-12-03

  • Closed date

    2014-12-03

  • Last modified date

    2015-09-30

  • APAR is sysrouted FROM one or more of the following:

    IV61559

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    AIX V7.1

  • Fixed component ID

    5765H4000

Applicable component levels

  • R710 PSY U865834

       UP15/05/19 I 1000

PTF to Fileset Mapping



Document information

More support for: AIX Enterprise Edition

Software version: 710

Operating system(s): AIX

Reference #: IV67514

Modified date: 30 September 2015