Skip to content

stanleytsang-amd/ucx

 
 

Repository files navigation




Unified Communication X

Unified Communication X (UCX) provides an optimized communication layer for Message Passing (MPI), PGAS/OpenSHMEM libraries and RPC/data-centric applications.

UCX utilizes high-speed networks for inter-node communication, and shared memory mechanisms for efficient intra-node communication.

Using UCX

Building and Running Internal Unit Tests

$ ./autogen.sh
$ ./contrib/configure-devel
$ make
$ make -C test/gtest test

UCX Performance Test

Start server:

$ ./src/tools/perf/ucx_perftest -c 0

Connect client:

$ ./src/tools/perf/ucx_perftest <server-hostname> -t tag_lat -c 0

Our Community

Licenses

UCX is licensed as:

Contributor Agreement and Guidelines

In order to contribute to UCX, please sign up with an appropriate Contributor Agreement.

Follow these instructions when submitting contributions and changes.

UCX Publications

To reference UCX in a publication, please use the following entry:

@inproceedings{shamis2015ucx,
  title={UCX: an open source framework for HPC network APIs and beyond},
  author={Shamis, Pavel and Venkata, Manjunath Gorentla and Lopez, M Graham and Baker, Matthew B and Hernandez, Oscar and Itigin, Yossi and Dubman, Mike and Shainer, Gilad and Graham, Richard L and Liss, Liran and others},
  booktitle={2015 IEEE 23rd Annual Symposium on High-Performance Interconnects},
  pages={40--43},
  year={2015},
  organization={IEEE}
}

To reference the UCX website:

@misc{openucx-website,
    title = {{The Unified Communication X Library}},
    key = {{{The Unified Communication X Library}},
    howpublished = {{\url{http://www.openucx.org}}}
}

UCX Architecture

Component Role Description
UCP Protocol Implements high-level abstractions such as tag-matching, streams, connection negotiation and establishment, multi-rail, and handling different memory types
UCT Transport Implements low-level communication primitives such as active messages, remote memory access, and atomic operations
UCS Services A collection of data structures, algorithms, and system utilities for common use
UCM Memory Intercepts memory allocation and release events, used by the memory registration cache

Supported Transports

Supported CPU Architectures

Packages

No packages published

Languages

  • C 59.1%
  • C++ 37.9%
  • M4 1.6%
  • Makefile 0.6%
  • Shell 0.5%
  • Java 0.2%
  • Other 0.1%