README

System-V plugin for yorick / python.

note: MacOSX does not provide semtimedop. The module provides a hacked
implementation that emulates the behaviour.

TIPS AND TRICKS:

- (linux) the maximum amount of shared memory is a kernel config parameter.
   You may find what value it's using one of these commands. The value
   printed is a number of bytes:
   
      sysctl kernel.shmmax
      
      cat /proc/sys/kernel/shmmax
      
   You can change this value 'on the fly' issuing one of these commands
   as 'root'. Here 3221225472 corresponds to 3 GB
      
      sysctl -w kernel.shmmax=3221225472
      
      echo 3221225472 > /proc/sys/kernel/shmmax
      
   To change the default value so it is setup everytime the kernel is booted:
      
      edit the file:
         
         /etc/sysctl.conf
      
      add/modify the entry:
         
         kernel.shmmax = <number of bytes>

- osx:

   sysctl -w kern.sysv.shmmax=33554432
   sysctl -w kern.sysv.shmmin=1
   sysctl -w kern.sysv.shmmni=256
   sysctl -w kern.sysv.shmseg=64
   sysctl -w kern.sysv.shmall=8192

    kern.sysv.shmmni may no work from the command line,
    edit /etc/sysctl.conf and reboot.



- trace memory usage of your yorick process
   watch ps -C yorick -F

- "ipcs" provides some handy commands to work from the shell.
  consult the man page for details

  linux:
    ipcs | grep 0xbadca
    ipcrm -M 0xbadcafe -S 0xbadcafe
   
    ipcrm `ipcs | egrep '0x808|0xdcb|0x101' | awk '{print "-S " $1}'`
    ipcrm `ipcs | egrep '0x808|0xdcb|0x101' | awk '{print "-M " $1}'`
    ipcrm `ipcs | egrep '0x808|0xdcb|0x101' | awk '{print "-Q " $1}'`

   osx:
    ipcrm `ipcs | egrep '0x808|0xdcb' | awk '{print "-s " $2}'`