unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 mpsched(1)							  mpsched(1)




 NAME
      mpsched - control the processor or locality domain on which a specific
      process executes

 SYNOPSIS
      mpsched -h

      mpsched -s

      mpsched [-g] [-P policy] [-T policy] [-l locality-domain-id] [-c spu]
	   command

      mpsched [-qu] [-P policy] [-l locality-domain-id] [-c spu] {-p pid}...

 DESCRIPTION
      mpsched controls the processor (spu), or locality domain (locality-
      domain-id) on which a process executes.  It can do this by binding a
      process to a particular processor or locality domain, or by setting
      the launch policy for the process.

      The command may be invoked in four manners.

      +	   With -h, it prints a help message.

      +	   With -s, it returns the hardware configuration of the system.
	   This includes information about the number of locality domains
	   and processors active in the system.

      +	   With a command and its arguments, it applies the binding or
	   launch policy to this command.

      +	   With -p, it applies the binding or launch policy to the specified
	   pid.

    Options
      The command-line options are:

      -c spu
	   Bind the specified processes to the spu listed.  This will ensure
	   that the processes always run on the indicated processor.  This
	   option may be used with the -P, -T, and -p options.

      -g   Enable gang scheduling on th No other options may be used with
	   -g.

      -h   Print a help message.

      -l locality-domain-id
	   Bind the specified processes to the locality-domain listed.	This
	   will ensure that the processes always run on the indicated
	   domain.  This option may be used with the -P, -T, and -p options.



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 mpsched(1)							  mpsched(1)




      -p pid
	   Specify process ID, pid.  To use the pid option, the caller must
	   be a member of a group having PRIV_MPCTL access, be superuser, or
	   have the same effective user ID as the pid.	Specifying a command
	   instead of the -p option does not require special privileges.
	   Multiple -p options may be specified per command line, although
	   each -p option can take only a single process ID.

      -q   Query the system regarding process bindings.	 This will return
	   information about whether processes are bound to a processor or
	   locality domain.  It will also report on the thread and process
	   launch policies for the processes.  If this option is used in
	   conjunction with -p then only those processes specified are
	   queried.  If this option is specified alone, then the status of
	   all processes on the system that differ from the default settings
	   are displayed.

      -s   Print the system hardware configuration.  No other options may be
	   specified.

      -u   Unbind the processes from any processor or locality domain
	   bindings that may be present.  This option can be used only with
	   -p and no other options may be specified.

      -P policy
	   Apply the specified policy to the processes.	 Launch policies
	   affect the locality domain on which a process is spawned.  This
	   option may be used with the -T, -p, -c, and -l options.  policy
	   is one of the following values.

	   RR	     Round robin launch policy.	 Under this policy,
		     successive child processes are launched in a round
		     robin fashion across the other locality domains in the
		     system relative to creating thread.

	   LL	     Least loaded launch policy.  Under this policy, child
		     processes are launched on the least loaded node in the
		     system at the time of creation.

	   FILL	     Fill first launch policy.	Under this policy,
		     successive processed are launched on the same locality
		     domain as their parent until one has been launched on
		     each processor in the locality domain.  At that point,
		     new processes are created on the next locality domain.

	   PACKED    Packed launch.  Under this policy, successive processes
		     are launched on the same locality domain as their
		     parent.  A different domain is never selected.

	   NONE	     No special policy.	 The default HP-UX launch policy is
		     used.



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 mpsched(1)							  mpsched(1)




      -T policy
	   Apply the specified policy to the threads of the process.  The
	   scheduling policies are the same as for the -P option except that
	   they apply to newly created threads instead of processes.  Also,
	   thread policies may only be specified on commands launched from
	   the command line of mpsched.	 The option may be used with the -P,
	   -p, -l, and -c options.

    Operands
      The command-line operands are:

      command
	   A command including its arguments.

 RETURN VALUE
      mpsched returns exit status 0 if command is successfully scheduled or
      -1 if it fails.

 EXAMPLES
      Execute the a.out file on processor 2:

	   mpsched -c 2 a.out

      Set the process launch policy for the existing process with pid 24217
      to round robin:

	   mpsched -P RR -p 24217

      Bind the processes with pids 1247 and 1842 to processor 4:

	   mpsched -c 4 -p 1247 -p 1842

 AUTHOR
      mpsched was developed by HP.

 SEE ALSO
      getprivgrp(1), setprivgrp(1M), fork(2), getprivgrp(2), mpctl(2),
      privgrp(4).
















 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000