Open MPI logo

Hardware Locality Development Mailing List Archives

  |   Home   |   Support   |   FAQ   |   all Hardware Locality Development mailing list

Subject: Re: [hwloc-devel] [hwloc-svn] svn:hwloc r1960
From: Jeff Squyres (jsquyres_at_[hidden])
Date: 2010-04-20 09:09:15


Done. BTW, I use the attached helper script to merge stuff in to the branches (can't remember if I've sent this before or not). It's a trivial thing, but it reduces the amount of stuff I have to type on the command line.

On Apr 20, 2010, at 8:49 AM, Jeff Squyres (jsquyres) wrote:

> Cool; I'll have a look right now.
>
> On Apr 20, 2010, at 8:43 AM, Brice Goglin wrote:
>
> > This needs to be backported to the 1.0 branch, but somebody might want
> > to fix/improve the text, so I am waiting a bit.
> >
> > Brice
> >
> >
> >
> >
> > bgoglin_at_[hidden] wrote:
> > > Author: bgoglin
> > > Date: 2010-04-20 04:06:03 EDT (Tue, 20 Apr 2010)
> > > New Revision: 1960
> > > URL: https://svn.open-mpi.org/trac/hwloc/changeset/1960
> > >
> > > Log:
> > > Add a documentation section about external helpers
> > > Text files modified:
> > > trunk/doc/Makefile.am | 14 +++++----
> > > trunk/doc/hwloc.doxy | 57 +++++++++++++++++++++++++++++++++++----
> > > 2 files changed, 58 insertions(+), 13 deletions(-)
> > >
> > > Modified: trunk/doc/Makefile.am
> > > ==============================================================================
> > > --- trunk/doc/Makefile.am (original)
> > > +++ trunk/doc/Makefile.am 2010-04-20 04:06:03 EDT (Tue, 20 Apr 2010)
> > > @@ -134,12 +134,14 @@
> > > -_at_mv -f $(DOX_DIR)/latex/tools.tex $(DOX_DIR)/latex/a00002.tex
> > > -_at_mv -f $(DOX_DIR)/html/envvar.html $(DOX_DIR)/html/a00003.html
> > > -_at_mv -f $(DOX_DIR)/latex/envvar.tex $(DOX_DIR)/latex/a00003.tex
> > > - -_at_mv -f $(DOX_DIR)/html/threadsafety.html $(DOX_DIR)/html/a00004.html
> > > - -_at_mv -f $(DOX_DIR)/latex/threadsafety.tex $(DOX_DIR)/latex/a00004.tex
> > > - -_at_mv -f $(DOX_DIR)/html/embed.html $(DOX_DIR)/html/a00005.html
> > > - -_at_mv -f $(DOX_DIR)/latex/embed.tex $(DOX_DIR)/latex/a00005.tex
> > > - -_at_mv -f $(DOX_DIR)/html/switchfromplpa.html $(DOX_DIR)/html/a00006.html
> > > - -_at_mv -f $(DOX_DIR)/latex/switchfromplpa.tex $(DOX_DIR)/latex/a00006.tex
> > > + -_at_mv -f $(DOX_DIR)/html/interoperability.html $(DOX_DIR)/html/a00004.html
> > > + -_at_mv -f $(DOX_DIR)/latex/interoperability.tex $(DOX_DIR)/latex/a00004.tex
> > > + -_at_mv -f $(DOX_DIR)/html/threadsafety.html $(DOX_DIR)/html/a00005.html
> > > + -_at_mv -f $(DOX_DIR)/latex/threadsafety.tex $(DOX_DIR)/latex/a00005.tex
> > > + -_at_mv -f $(DOX_DIR)/html/embed.html $(DOX_DIR)/html/a00006.html
> > > + -_at_mv -f $(DOX_DIR)/latex/embed.tex $(DOX_DIR)/latex/a00006.tex
> > > + -_at_mv -f $(DOX_DIR)/html/switchfromplpa.html $(DOX_DIR)/html/a00007.html
> > > + -_at_mv -f $(DOX_DIR)/latex/switchfromplpa.tex $(DOX_DIR)/latex/a00007.tex
> > > endif
> > > endif
> > >
> > >
> > > Modified: trunk/doc/hwloc.doxy
> > > ==============================================================================
> > > --- trunk/doc/hwloc.doxy (original)
> > > +++ trunk/doc/hwloc.doxy 2010-04-20 04:06:03 EDT (Tue, 20 Apr 2010)
> > > @@ -235,13 +235,8 @@
> > > hwloc/cpuset.h.
> > >
> > > Moreover, hwloc also comes with additional helpers for
> > > -interoperability with several commonly used environments. For Linux,
> > > -some specific helpers are available in hwloc/linux.h, and
> > > -hwloc/linux-libnuma.h if using libnuma. On glibc-based systems,
> > > -additional helpers are available in hwloc/glibc-sched.h. For Linux
> > > -systems with the OpenFabrics verbs library, some dedicated helpers are
> > > -provided in hwloc/openfabrics-verbs.h (this helper file is not yet
> > > -useful on non-Linux systems with the OpenFabrics verbs library).
> > > +interoperability with several commonly used environments.
> > > +See the \ref interoperability section for details.
> > >
> > > To precisely define the vocabulary used by hwloc, a \ref termsanddefs
> > > section is available and should probably be read first.
> > > @@ -532,6 +527,54 @@
> > >
> > >
> > >
> > > +\page interoperability Interoperability with other software
> > > +
> > > +hwloc offers its own portable interface but it still may have to
> > > +interoperate with specific or non-portable libraries that manipulate
> > > +some similar objects.
> > > +It thus offers several specific helpers to help converting between
> > > +those specific interfaces and hwloc.
> > > +
> > > +Such external libraries may be specific to some OS or may not always
> > > +be installed, so hwloc does not explicitly depend on them.
> > > +However, when a custom program depends on such a library, it may optionally
> > > +include the corresponding hwloc helper to extend the hwloc interface with
> > > +dedicated helpers.
> > > +
> > > +<dl>
> > > +
> > > +<dt>Linux specific features</dt>
> > > + <dd>
> > > + hwloc/linux.h offers Linux specific helpers that access some non-portable
> > > + features of the Linux system, such as binding threads through their tid
> > > + or parsing kernel CPU mask files.
> > > + </dd>
> > > +
> > > +<dt>Linux libnuma</dt>
> > > + <dd>
> > > + hwloc/linux-libnuma.h provides conversion helpers between hwloc CPU sets
> > > + and libnuma specific types such as nodemasks and bitmasks.
> > > + It helps you use libnuma memory binding functions with hwloc CPU sets.
> > > + </dd>
> > > +
> > > +<dt>Glibc</dt>
> > > + <dd>
> > > + hwloc/glibc-sched.h offers conversion routines between Glibc and hwloc
> > > + CPU sets so as to manipulate functions such as sched_setaffinity()
> > > + together with hwloc.
> > > + </dd>
> > > +
> > > +<dt>OpenFabrics Verbs</dt>
> > > + <dd>
> > > + hwloc/openfabrics-verbs.h help interoperability with the OpenFabrics Verbs
> > > + interface, for instance by returning the list of processors near an
> > > + InfiniBand device.
> > > + </dd>
> > > +
> > > +</dl>
> > > +
> > > +
> > > +
> > > \page threadsafety Thread safety
> > >
> > > Like most libraries that mainly fill data structures, hwloc is not
> > > _______________________________________________
> > > hwloc-svn mailing list
> > > hwloc-svn_at_[hidden]
> > > http://www.open-mpi.org/mailman/listinfo.cgi/hwloc-svn
> > >
> >
> > _______________________________________________
> > hwloc-devel mailing list
> > hwloc-devel_at_[hidden]
> > http://www.open-mpi.org/mailman/listinfo.cgi/hwloc-devel
> >
>
>
> --
> Jeff Squyres
> jsquyres_at_[hidden]
> For corporate legal information go to:
> http://www.cisco.com/web/about/doing_business/legal/cri/
>
>
> _______________________________________________
> hwloc-devel mailing list
> hwloc-devel_at_[hidden]
> http://www.open-mpi.org/mailman/listinfo.cgi/hwloc-devel
>

-- 
Jeff Squyres
jsquyres_at_[hidden]
For corporate legal information go to:
http://www.cisco.com/web/about/doing_business/legal/cri/


  • application/octet-stream attachment: merge