Free Knowledge Resources


Linux Manual Pages


Free Software * Books

Source Code

Free Media

Linux

pmistart(3)

NAME

   pmiStart - establish a new LOGIMPORT context

C SYNOPSIS

   #include <pcp/pmapi.h>
   #include <pcp/impl.h>
   #include <pcp/import.h>

   int pmiStart(const char *archive, int inherit);

   cc ... -lpcp_import -lpcp

Perl SYNOPSIS

   use PCP::LogImport;

   pmiStart($archive, $inherit);

DESCRIPTION

   As  part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)),
   pmiStart creates a new context.  Each context maintains  the  following
   state and metadata:

   *  The  base name (archive) for the physical  files that constitute the
      output PCP archive.

   *  The source hostname for the data that will be  written  to  the  PCP
      archive.   Defaults to the hostname of the localhost, but can be set
      using pmiSetHostname(3).

   *  The source timezone for the PCP archive.  Defaults to  the  timezone
      of the localhost, but can be set using pmiSetTimezone(3).

   *  Metrics and instance domains, as defined by pmiAddMetric(3).

   *  Instances for each instance domain, as defined by pmiAddInstance(3).

   *  Handles  as  defined  by  pmiGetHandle(3).  Each handle is a metric-
      instance pair, and each metric-instance pair may have an  associated
      value in each record written to the output PCP archive.

   *  An optional set of data values for one or more metric-instance pairs
      (ready for the next record to be written to the output PCP  archive)
      as defined by calls to pmPutValue(3) or pmPutValuehandle(3).

   If  inherit  is  true,  then  the  new context will inherit any and all
   metadata (metrics, instance domains, instances and  handles)  from  the
   current context, otherwise the new context is created with no metadata.
   The basename for the output  PCP  archive,  the  source  hostname,  the
   source  timezone  and  any data values from the current context are not
   inherited.  If this is the first call to pmiStart the metadata will  be
   empty independent of the value of inherit.

   Since  no  physical  files  for  the output PCP archive will be created
   until the first call to pmiWrite(3) or pmiPutRecord(3),  archive  could
   be NULL to create a convenience context that is populated with metadata
   to be inherited by subsequent contexts.

   The return value is a context  identifier  that  could  be  used  in  a
   subsequent  call  to  pmUseContext(3)  and  the new context becomes the
   current context which persists for all subsequent calls  up  to  either
   another  pmiStart  call  or  a  call  to  pmiUseContext(3) or a call to
   pmiEnd(3).

DIAGNOSTICS

   It is an error if the physical  files  archive.0  and/or  archive.index
   and/or archive.meta already exist, but this is not discovered until the
   first attempt is made to output some data  by  calling  pmiWrite(3)  or
   pmiPutRecord(3),   so   pmiStart  always  returns  a  positive  context
   identifier.

SEE ALSO

   LOGIMPORT(3),    pmiAddInstance(3),     pmiAddMetric(3),     pmiEnd(3),
   pmiErrStr(3),    pmiGetHandle(3),    pmiPutResult(3),   pmiPutValue(3),
   pmiPutValueHandle(3),       pmiSetHostname(3),       pmiSetTimezone(3),
   pmiUseContext(3) and pmiWrite(3).



Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.


Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.


Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.


birds banner