NAME

       charliecloud - Lightweight user-defined software stacks for high-performance computing

WHAT IS CHARLIECLOUD?

       Charliecloud  provides  user-defined software stacks (UDSS) for high-performance computing
       (HPC) centers. This “bring your own software stack” functionality addresses needs such as:

       • software dependencies that are numerous, complex, unusual,  differently  configured,  or
         simply newer/older than what the center provides;

       • build-time  requirements  unavailable  within  the center, such as relatively unfettered
         internet access;

       • validated software stacks and configuration to meet the standards of a particular  field
         of inquiry;

       • portability of environments between resources, including workstations and other test and
         development system not managed by the center;

       • consistent environments,  even  archivally  so,  that  can  be  easily,  reliabily,  and
         verifiably reproduced in the future; and/or

       • usability and comprehensibility.

HOW DOES IT WORK?

       Charliecloud uses Linux user namespaces to run containers with no privileged operations or
       daemons and minimal configuration changes  on  center  resources.   This  simple  approach
       avoids  most  security risks while maintaining access to the performance and functionality
       already on offer.

       Container images can be built using Docker or anything else that can generate  a  standard
       Linux filesystem tree.

HOW DO I LEARN MORE?

       • Documentation: https://hpc.github.io/charliecloud

       • GitHub repository: https://github.com/hpc/charliecloud

       • We  wrote  an  article  for  USENIX’s  magazine ;login: that explains in more detail the
         motivation  for  Charliecloud   and   the   technology   upon   which   it   is   based:
         https://www.usenix.org/publications/login/fall2017/priedhorsky

       • A     more     technical     resource     is     our    Supercomputing    2017    paper:
         https://dl.acm.org/citation.cfm?id=3126925

WHO IS RESPONSIBLE?

       The core Charliecloud team at Los Alamos is:

       • Reid Priedhorsky <reidpr@lanl.gov>, co-founder and BDFL

       • Tim Randles <trandles@lanl.gov>, co-founder

       • Michael Jennings <mej@lanl.gov>

       • Jordan Ogas <jogas@lanl.gov>

       Patches (code, documentation, etc.) contributed by:

       • Reid Priedhorsky <reidpr@lanl.gov>

       • Rusty Davis <rustyd@lanl.gov>

       • Oliver Freyermuth <o.freyermuth@googlemail.com>

       • Christoph Junghans <junghans@lanl.gov>

       • Jordan Ogas <jogas@lanl.gov>

       • Matthew Vernon <mv3@sanger.ac.uk>

       • Peter Wienemann <wienemann@physik.uni-bonn.de>

       • Lowell Wofford <lowell@lanl.gov>

HOW CAN I PARTICIPATE?

       Questions, comments, feature requests, bug reports, etc. can be directed to:

       • our mailing list: charliecloud@groups.io or https://groups.io/g/charliecloud

       • issues on GitHub

       Patches are much appreciated on the software itself as well as documentation.  Optionally,
       please include in your first patch a credit for yourself in the list above.

       We are friendly and welcoming of diversity on all dimensions.

COPYRIGHT AND LICENSE

       Charliecloud is copyright © 2014–2018 Los Alamos National Security, LLC. This software has
       been approved for open source release, LA-CC 14-096.

       Licensed under the Apache License, Version 2.0 (the  “License”);  you  may  not  use  this
       software  except in compliance with the License. A copy of the license is included in file
       LICENSE.

       This material was produced under U.S. Government contract DE-AC52-06NA25396 for Los Alamos
       National Laboratory (LANL), which is operated by Los Alamos National Security, LLC for the
       U.S. Department of  Energy.  The  U.S.  Government  has  rights  to  use,  reproduce,  and
       distribute  this  software.  NEITHER  THE GOVERNMENT NOR LOS ALAMOS NATIONAL SECURITY, LLC
       MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR ASSUMES ANY  LIABILITY  FOR  THE  USE  OF  THIS
       SOFTWARE.  If  software  is  modified  to produce derivative works, such modified software
       should be clearly marked, so as not to confuse it with the version available from LANL.

   Reporting bugs
       If Charliecloud was obtained from your Linux distribution,  use  your  distribution’s  bug
       reporting procedures.

       Otherwise, report bugs to: <https://github.com/hpc/charliecloud/issues>

SEE ALSO

       ch-build(1), ch-build2dir(1), ch-docker2tar(1), ch-pull2dir(1), ch-pull2tar(1), ch-run(1),
       ch-ssh(1), ch-tar2dir(1)

       Full documentation at: <https://hpc.github.io/charliecloud>

NOTE

       These man pages are for Charliecloud version 0.9.10 (Git commit ).

AUTHOR

       Reid Priedhorsky, Tim Randles, and others

COPYRIGHT

       2014–2018, Los Alamos National Security, LLC

                           2019-09-08 18:23 Coordinated Universal Time            CHARLIECLOUD(1)