Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Network Locality
C Shell Other
branch: master
Failed to load latest commit information.
config First public commit of netloc.
contrib netloc-nightly-tarball: bump up to jansson 2.6
doc doc: update dist to new map doc sections
include map: split the map API into several sections in the doc
jansson jansson/jansson.m4: update comments for future Jeff
src map: use the new hwloc_topology_set/get_userdata() from hwloc 1.10
tests configry: use $(JANSSON_CPPFLAGS) instead of explicit flags
tools configry: use $(JANSSON_CPPFLAGS) instead of explicit flags
.gitignore jansson: add embedded version of Jansson 2.6
AUTHORS First public commit of netloc.
NEWS Update the NEWS file.
README Minor formatting change
VERSION master is now v0.6 configury: also use $(JANSSON_LDFLAGS) and $(JANSSON_LIBS) Add a pkg-config file.


Copyright (c) 2013      University of Wisconsin-La Crosse.
                        All rights reserved.
Copyright (c) 2013      Cisco Systems, Inc.  All rights reserved.


See COPYING in top-level directory.
Additional copyrights may follow



Building netloc

The typical installation follows the following pattern:

shell$ ./configure [options...]
shell$ make
shell$ make install

There are a few configuration options available. See ./configure --help for
a complete list.

Common Configuration Options

   Install netloc into the base directory specified.

Required Support Libraries

   Installation directory of the Jansson JSON parsing library.

   Installation directory of the hwloc library.


Using netloc

The netloc model separates network topology discovery mechanism from the
mechanism for querying that data via the netloc API.

Using netloc: Discovering the network topology

The netloc reader tools provide the functionality to discover the network
topology for various types of networks. Below is a list and brief description
of the readers currently available in this release of netloc. Further
information about each of these tools can be found in their documentation.

 - netloc_reader_ib
   Reader for InfiniBand network data.

 - netloc_reader_of
   Reader for Ethernet network data managed by an OpenFlow controller.
   Controllers currently supported:
     - OpenDaylight
     - Floodlight

Using netloc: Query API

The user-facing API is defined in the following header files:
  - include/netloc.h
  - include/netloc_map.h


Unit Tests

A small number of unit tests and testing data have been made available
as part of this distribution. To compile these tests use the following

shell$ make check

The tests can be run from the tests directory without any command line

Something went wrong with that request. Please try again.