vparstatus

vparstatus

vparstatus - Displays virtual partition and available resources information.

 vparstatus(1M)                                                       vparstatus(1M) NAME      vparstatus - display information about one or more virtual partitions SYNOPSIS      vparstatus [-v  -M] [-p vp_name]...  [-D db_file]      vparstatus -A [-M]      vparstatus w      vparstatus e      vparstatus -R [-p vp_name] DESCRIPTION      The various forms of the vparstatus command display:      +  The attributes and hardware resources associated with one or more virtual partitions (vPars) in either summary (the default) or detailed format.  The -M option presents the same data in machine- readable format.      +  Resources currently available, that is, not assigned to any virtual partition.  The -M option presents the same data in machine- readable format.      +  The name of the current virtual partition, that is, the virtual partition from which the command is run.      +  The virtual partition monitor's event log.      +  Processor Information Module (PIM) data from the most recent resetting of a virtual partition.      Only a superuser can execute the vparstatus command.      If no arguments are supplied, vparstatus displays a summary format of      all attributes and resources of all virtual partitions in the monitor      database.   One or more virtual partitions may be specified explicitly      in order to restrict the output to information about the selected      virtual partitions.  The -D option lists similar information from an      alternate database file, but with a major difference.  See the      description of the -D option for further details.      There are three major listing formats.  The format chosen depends on      command options and forms:      + The summary format lists name, attributes, and resource totals.  It is displayed if neither the -v nor -M option is used.      + The detailed format lists name, attributes, and detailed resource assignments, one per line with annotative headings.  The -v option produces this format.      + The machine readable format displays the same information as the detailed format, except that field descriptive headers are omitted, and the information is all on one line.  Individual fields are separated from each other by four delimiters.These are all described below.      Three additional formats are provided for the -w, -e and -R options.      Information displayed by vparstatus includes the following:      + The name of the virtual partition (limited to 30 characters in summary format)      + The state of the virtual partition, from the list below: Up: The virtual partition has notified the monitor that it is up. This is the normal state of a running virtual partition, however it does not necessarily mean that the virtual partition has completed its initialization and is fully operational. Down: The virtual partition is fully halted.  This could be the result of a normal /etc/shutdown -h command, or a vparreset of a partition with its autoboot attribute set to manual.  It is also the initial state of a virtual partition immediately after the virtual partition monitor is started. Load: The monitor is loading the kernel image of the virtual partition.  This state precedes the Boot state. Boot: The virtual partition has been launched, but has not completely booted. Crash: The virtual partition is shutting down ungracefully (either a panic or a reset) Shut: The virtual partition is shutting down gracefully Hung: The virtual partition has stopped sending heartbeat messages to the monitor. N/A: The virtual partition is in an alternate database file, and so has no state.      +  The static/dynamic resource attribute      +  The auto/manual boot attribute      +  The path to the kernel (limited to 25 characters in summary format)      +  The boot options (limited to 5 characters in summary format)      +  Summary or detailed CPU, I/O, and memory resource allocations    Options      vparstatus recognizes the following command line options and      arguments:      -p vp_name        Restricts the command display to information about      vp_name.  By default, information about all virtual      partitions in the monitor database or specified      alternate partition database is displayed.  Multiple      vp_names may be specified, except when used to display      PIM data.      -D db_file      Displays information from the alternate partition      database file db_file rather than from the monitor      database.      The attributes and resources of a vPar in an alternate      database file were specified in either the vparcreate      or vparmodify command, but have not necessarily been      checked for existence on a running system.  They are      referred to as "requested" information.  Existence of      the attributes and resources of a vPar in the live      monitor database have been verified; they are referred      to as "effective" information.      -v      Presents a detailed display, one attribute or resource      per line. Each attribute and resource type is      identified.      CPU resources are identified by path when path      information is available. Some CPU resources may not      be known when displaying the status of alternate      database vPars or vPars in the Down state.  In this      case, "<no path>" is displayed.      -A      Displays information about available resources (that      is, those not assigned to any virtual partition) in      the virtual partition monitor's database. The monitor      must be running.Resources are displayed one per      line.      -M      Displays information in a machine readable format.      Individual fields are separated by one of four      delimiters:      + The colon (:) separates each field and resource type.For example, the state, attribute information, and kernel path would be displayed as: Up:Static,Autoboot:/stand/vmunix      + The semicolon (;) separates subfields of a resource type.For example, CPU resources are shown as: 5/10;33,37;51,53,55;<>,<>,<> where the first subfield shows the minimum and maximum CPUs configured for the virtual partition; the second subfield lists the bound, or specified path, CPUs specifically configured by the user; the third subfield lists the remaining bound CPUs, which are assigned by the monitor; and the final subfield lists the unbound, or floating, CPUs. In the example above, the paths of the unbound CPUs are not known.   This could be the case because the example vPar is in an alternate database, or the vPar is in a Down state for which unbound CPUs are not assigned.  In this case, "<>" is displayed in place of the path.      + The comma (,) separates individual items in a list of similar items, such as the fixed path CPUs in the previous example.      + The slash (/) separates all other related items, such as the CPU minimum and maximum in the same example.      Elements in the display are in the same order as the      corresponding non-machine-readable display (-v or -A).      -w      Displays the name of the current virtual partition      (the one in which the command is executed).  The      monitor must be running.      -e      Displays the monitor's event log, a circular file      roughly 4K bytes long.  Once the file is full, new      entries overlay old ones to the nearest character.  As      a result, the first entry displayed may be missing      some leading characters.The monitor must be running.      -R      Displays Processor Information Module (PIM) data from      the most recent reset of the specified virtual      partition.  If a virtual partition is not specified,      PIM data from the current virtual partition, that is,      the one in which the command is executed, is      displayed.      If the virtual partition has not been reset, or if PIM      data has been cleared since then, no PIM data is      available so a message to that effect is displayed.      The monitor must be running. RETURN VALUE      The vparstatus command exits with one of the following values:      0   Successful completion.      1   Syntax error or invalid option. EXAMPLES      These examples assume the existence of an N-class hardware system,      Europe, on which the virtual partition database Norway is currently      loaded in the virtual partition monitor.Norway has two configured      virtual partitions: Oslo, and Bergen.  The vparstatus command is run      from Oslo.      Europe has eight CPUs, two System Bus Adapters (SBAs), each with six      Local Bus Adapters (LBAs), and 2 Gbytes of main memory.  These      resources are allocated among Oslo and Bergen as follows:      Oslo: +  Two bound CPUs at hardware paths 33 and 37. The CPU at 33 was    specified by the user with the -a cpu:path resource    specification.  The CPU at 37 was assigned by the monitor from    the pool of CPUs available when Oslo was booted. +  One floating (unbound) CPU at hardware path 41. +  One SCSI boot disk at SBA/LBA/path 0/0/2/0.6.0. +  One terminal at 0/0/4/0. +  One LBA (0/4) to which are attached several LAN adapters. +  Specific memory addresses 0x4000000 to 0xc000000 (Range = 64 MB)    and 0x20000000 to 0x40000000 (Range = 128 MB).  These specific    ranges are part of a total memory allocation of 704 MB.     Bergen: +  Two bound CPUs at hardware path 97 and 101, both assigned by the    monitor. +  Two unbound CPUs at hardware paths 93 and 99. +  One SCSI boot disk at 1/4/0/0.5.0. +  One LBA (1/10) to which are attached several LAN adapters +  Specific memory 0x44000000 to 0x50000000 (Range = 192 MB) and    0x60000000 to 0x80000000 (Range = 512 MB).These specific    ranges are part of a total memory allocation of 768 MB.      Display a summary format of all attributes and resources in all      virtual partitions: # vparstatus [Virtual Partition]   Boot Virtual Partition NameState Attributes Kernel Path        Opts ============================== ===== ========== ========================= ===== OsloUp    Stat,Auto /stand/vmunix BergenUp    Dyn,Manl /stand/vmunix [Virtual Partition Resource Summary]    CPU   Num      Memory (MB)   CPU   Bound/   IO # Ranges/ Virtual Partition Name Min/Max  Unbound  devs Total MB    Total MB ============================== ================  ==== ==================== Oslo       2/  4    21     3    2/640    704 Bergen       2/  4    22     2    2/704    768      Display detailed attributes and resources of partition Oslo: # vparstatus -p Oslo -v [Virtual Partition Details] Name:       Oslo State:       Up Attributes:   Static,Autoboot Kernel Path:  /stand/vmunix Boot Opts: [CPU Details] Min/Max:  2/4 Bound by User [Path]:33 Bound by Monitor [Path]:  37 Unbound [Path]:  41 [IO Details]    0.0.2.0.6.0 BOOT    0.0.4.0    0.4 [Memory Details] Specified [Base  /Range]:  0x4000000/64   (bytes) (MB)    0x20000000/128 Total Memory (MB):  704      Display Bergen's CPU resources in machine-readable format: # vparstatus -p Bergen -M Bergen:Up:Dynamic,Manual:/stand/vmunix::2/4;;97,101;93,99:1.4.0.0.5.0 BOOT,1.10 :0x44000000/192,0x60000000/512;768      Display the name of the current virtual partition: # vparstatus -w The current virtual partition is Oslo. AUTHOR      vparstatus was developed by the Hewlett-Packard Company. SEE ALSO  vparboot(1M)  ,  vparcreate(1M)  ,  vparmodify(1M)  ,  vparremove(1M)  ,  vparreset(1M)  ,  vparresources(5)  ,  vpartition(5)  .