nstats(1)                                                            nstats(1)


NAME
     nstats - Origin 2000/200 NUMA Memory Management Statistics

SYNOPSIS
     nstats [node-path] [-hav] [-r command]


DESCRIPTION
     Display the absolute Origin 2000/200 NUMA Memory Management statistics,
     or display the relative Origin 2000/200 NUMA Memory Management statistics
     after running a command.  This command has no meaning and no effect on
     other Origin platforms.


OPTIONS
     -h   Print a small summary of usage.

     -a   Print absolute statistics for all nodes in the system.

     -r   Run the command specified by command and display the relative
          statistics at the end of the command. Nstats samples the absolute
          statistics before running the command and after running the command.
          When the command exits, nstats displays the difference between the
          two samples.


OUTPUT
     Migration Threshold
          Current migration threshold for this node expressed as a percentage
          of the maximum threshold supported by the memory reference counters.
          This maximum threshold is shown by the sn(1) command, and it can be
          set by the system administrator to be either 2047 or 524287. Only
          machines with PREMIUMM directory memory support the higher value of
          524287.  The migration threshold determines how aggressively the
          system is trying to migrate memory to the nodes that are issuing
          most memory accesses to a page of memory. Migration is requested
          when the difference between the number of local accesses and the
          number of remote accesses exceeds the number defined by the
          migration threshold.


     Counter Interrupts
          This is the number of interrupts generated by the memory reference
          counters, including interrupts for migration and interrupts for
          updating the extended memory reference counters (refcnt(5)).


     Auto Migrations To Node
          Number of pages automatically migrated to a node.


     Auto Migrations From Node
          Number of pages automatically migrated out of a node.


     Auto Migration Skips
          Rejected automatic migration requests due to a page being frozen or
          not in a migratable state.


     User Migrations To Node
          Number of pages migrated to a node due to an explicit user migration
          request.


     User Migrations From Node
          Number of pages migrated out of a node due to an explicit user
          migration request.


     User Migration Skips
          Rejected user migration requests due to a page being frozen or not
          in a migratable state.


     CoalD Migrations To Node
          Number of pages migrated to a node due large page coalescing.


     CoalD Migrations From Node
          Number of pages migrated from a node due to large page coalescing.


     CoalD Migration Skips
          Rejected large page coalescing migration requests due to a page
          being frozen or not in a migratable state.


     Frozen Pages In Node
          Pages frozen due to excessive migration.


     Melted Pages In Node
          Pages melted (unfrozen) after having been frozen for a period of
          time.


EXAMPLE
     To display the NUMA statistics for all nodes
        $ nstats -a
     To run a command and display NUMA statistics at the end
        $ nstats -r ls -l


RESTRICTIONS
     All statistics are global.


SEE ALSO
     numa(5), refcnt(5), gr_sn(1), sn(1), gr_nstats(1), linkstat(1),
     xbstat(1m), hwgraph(4), pminfo(1).


                                                                        Page 3