monitor_utils.h

Go to the documentation of this file.

/*
 * ApMon - Application Monitoring Tool
 * Version: 2.1.0
 *
 * Copyright (C) 2006 California Institute of Technology
 *
 * Permission is hereby granted, free of charge, to use, copy and modify 
 * this software and its documentation (the "Software") for any
 * purpose, provided that existing copyright notices are retained in 
 * all copies and that this notice is included verbatim in any distributions
 * or substantial portions of the Software. 
 * This software is a part of the MonALISA framework (http://monalisa.cacr.caltech.edu).
 * Users of the Software are asked to feed back problems, benefits,
 * and/or suggestions about the software to the MonALISA Development Team
 * (developers@monalisa.cern.ch). Support for this software - fixing of bugs,
 * incorporation of new features - is done on a best effort basis. All bug
 * fixes and enhancements will be made available under the same terms and
 * conditions as the original software,

 * IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY FOR
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
 * OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY DERIVATIVES THEREOF,
 * EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 * THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS
 * PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NO
 * OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
 * MODIFICATIONS.
 */

#ifndef monitor_utils_h
#define monitor_utils_h

namespace apmon_mon_utils {

  typedef struct PsInfo {
    double etime; /* elapsed time since the job started, in seconds */
    double cputime; /* CPU time allocated so far to this job. */
    double pcpu; /* percent of the processor currently used by the job */
    double pmem; /* percent of the system memory currently used by the job */
    double rsz; /* resident image size of the job, in KB */
    double vsz; /* amount of the virtual memory occupied by the job, in KB */
    double open_fd; /* number of opened file descriptors */
  } PsInfo;

  typedef struct JobDirInfo {
    /* the size of the job's working directory */
    double workdir_size; 
    /* size of the partition on which the working directory resides, in MB */
    double disk_total; 
    /* the amount of disk used on the working directory's partition */
    double disk_used;
    /* the amount of disk free on the working directory's partition */
    double disk_free;
    /* disk usage in percent on the working directort's partition */
    double disk_usage; 
  } JobDirInfo;

  long *getChildren(long pid, int& nChildren) throw(runtime_error);
  
  void readJobInfo(long pid, PsInfo& info) throw(runtime_error);

  long parsePSTime(char *s);

  void readJobDiskUsage(MonitoredJob job, JobDirInfo& info) 
    throw(runtime_error); 
}

#endif