Index for Section 1

Alphabetical listing for I

Bottom of page

imc_init(1)
NAME
  imc_init - Initializes and configures the Memory Channel Application
  Programming Interface (API) library on the current host

SYNOPSIS
  /usr/sbin/imc_init [-a maxalloc] [-r maxrecv]

FLAGS
  -a maxalloc
	    Specifies, in megabytes, the total amount of Memory Channel
	    address space to be made available to the Memory Channel API
	    library.  The default amount of address space is 10 MB. This is a
	    clusterwide limit.

  -r maxrecv
	    Specifies, in megabytes, the maximum amount of Memory Channel
	    address space that can be attached for receive on the host. The
	    default amount of receive space is 10 MB. This limit applies only
	    to the current host.

DESCRIPTION
  The imc_init command initializes and configures the MEMORY CHANNEL API
  library on the current host. Initializing the Memory Channel API library
  occurs either by automatic execution of the imc_init command at system boot
  time, or by the system administrator invoking the command from the command
  line after the system boots.

  Initializing the Memory Channel API library at system boot time is
  controlled by the IMC_AUTO_INIT variable in the /etc/rc.config file.	If
  the value of this variable is set to 1, the imc_init command is invoked at
  system boot time.  When the Memory Channel API library is initialized at
  boot time, the values of the -a maxalloc and	-a maxrecv flags are set to
  the values specified by the IMC_MAX_ALLOC and IMC_MAX_RECV variables
  respectively in the /etc/rc.config file.

  If the IMC_AUTO_INIT variable is set to 0, the Memory Channel API library
  is not initialized at system boot time. The system administrator must
  invoke the imc_init command to initialize the API. The parameter values in
  the /etc/rc.config file are not used when the imc_init command is manually
  invoked.

  The imc_init command initializes the Memory Channel API library the first
  time it is invoked, whether this happens during system boot time or after
  the system has booted. The value of the -a maxalloc flag should be the same
  on all hosts in the Memory Channel API cluster. If different values are
  specified, the maximum value specified for any host determines the
  clusterwide value that applies to all hosts.

  After the Memory Channel API has initialized on the current host, the
  system administrator can invoke the imc_init command again to reconfigure
  the values of the maxalloc and maxrecv resource limits, without forcing a
  reboot. The system administrator can increase or decrease either limit, but
  the new limits cannot be lower than the current usage of the resources.
  Reconfiguring the Memory Channel API cluster from the command line does not
  read or modify the values specified in the /etc/rc.config file. The system
  administrator can use the rcmgr command to modify the parameters and have
  them take effect when the system reboots.

  You must have root privileges to execute the imc_init command.

ERROR MESSAGES
  The imc_init command prints the following error messages:

    ·  Receive area is bigger than the maximum allocation

       The receive size is larger than the maximum allocation size.

    ·  No Memory Channel memory available

       There is not enough Memory Channel address space to initialize the
       MEMORY CHANNEL API library.

    ·  No Memory Channel resources available

       There are insufficient Memory Channel data structures available to
       initialize the Memory Channel API library.

    ·  Memory Channel is not initialized for user access

       This host has not been initialized to use the Memory Channel API.
       Ensure that the Memory Channel cables are properly connected.

    ·  Privileged command

       You do not have root privileges. You must have root privileges to
       execute the imc_init command.

    ·  System wired memory limit cannot be exceeded. See kernel vm parameter
       vm-syswiredpercent

       An attempt has been made to exceed the maximum quantity of system
       wired memory. The amount of Memory Channel address space that can be
       attached for receive on the host cannot be increased beyond the limit
       imposed by the system parameter vm-syswiredpercent.

    ·  Invalid parameter specification

       An attempt has been made to set the maxalloc parameter or the maxrecv
       parameter to zero (0), or to a non-numeric or a negative value.

FILES
  /usr/sbin/imc_init
	    Specifies the command path.

  /etc/rc.config
	    Contains the variables that control whether the Memory Channel
	    API library is initialized at system boot time, and specifies the
	    parameter values to be applied on initialization.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: rcmgr(8), imcs(1)

Index for Section 1

Alphabetical listing for I

Top of page