Home

Oneclick is supporting tool used to automate some of the workload when using EACirc Framework. Usually EACirc have to be executed in many different configurations and each configuration multiple times. After execution, the results from each workunit have to be processed into bigger picture. Doing this process by hand is time consuming and prone to errors. In answer to this, Oneclick was developed. Aim of this project is to do this work instead of researchers so that they can spend their time with researching things, not Bash scripts.

Currently Oneclick allows user to:

• Generate multiple different configuration files for EACirc based on simple rules.
• Generate scripts used for running of EACirc on remote server as well as scripts for download of results.
• Post-process output of multiple EACirc runs, detect errors or inconsistencies and give final result of whole run.

Oneclick User documentation

• Building Oneclick
  Build instructions for project under Windows and Linux systems.
• Prerequisites
  You will need to be able to run Perl scripts for upload and download of remote workunits.
• Running Oneclick
  Notes for running application from configuration files generation to result processing.
  • Configuration files and scripts generation
    How to generate configuration files and where to find them.
    • Configuration file options
      Setting up file for workunit generation, example configuration included and described.
  • Creating workunits on BOINC
    Using and modifying upload script, possible errors reviewed.
  • Downloading results from BOINC
    Description of download script, PHP script and assimilator.
  • Results processing
    How to process results and interpret them, described post-processors.

Oneclick developer notes

• Output files and logs
  Described output files and their location and how to change default directories.
• Adding Oneclick compoments
  How to add or modify Oneclick code.
• Oneclick@Centaur
  Result processing directly at server. No need for downloading.
• Additional libraries and dependencies
  Third party libraries used in project, dependency on EACirc project.

Authors and licence

The framework is developed at the Centre for Research on Cryptography and Security, Masaryk University, Brno, Czech Republic. It's licensed under MIT licence, see the file in the repository root. The project uses some third party code, licence details for these parts can be found in the LicenceReadMe file in the repository root.

• Michal Hajas
  2015-now (Java bytecode simulator)
• Karel Kubíček
  2014-now (TEA)
• Jiří Novotný
  2014-now (build system, CUDA core implementation)
• Ľubomír Obrátil
  2014-now (Oneclick development)
• Zdenek Říha
  2013-now (Java bytecode emulator)
• Marek Sýs
  2013-now (project concept, results interpretation)
• Petr Švenda
  2008-now (project lead, initial implementation)
• Martin Ukrop
  2012-now (framework, CAESAR, polynomial backend)

Former:

• Milan Čermák
  2012-now (initial CUDA implementation)
• Ondrej Dubovec
  2011-2012 (SHA-3 candidates testing)
• Dušan Klinec
  2014-2014 (polynomial backend)
• Matěj Prišťák
  2011-2012 (object model and refactoring, batch mode for BOINC via XML, eStream candidates testing)
• Tobiáš Smolka
  2011-2012 (BOINC related support)