catj 0.1.0

A light process isolation sandbox used for competitive programming contest
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# CatJ

[![CI](https://github.com/yjl9903/CatBox/actions/workflows/ci.yml/badge.svg)](https://github.com/yjl9903/CatBox/actions/workflows/ci.yml) [![](https://img.shields.io/crates/v/catj)](https://crates.io/crates/catj)

A light process isolation sandbox used for Competitive Programming contest.

## Features
 
+ [cgroups](https://man7.org/linux/man-pages/man7/cgroups.7.html): Record cpu and memory usage (may fall back to [getrusage](https://man7.org/linux/man-pages/man2/getrusage.2.html))
+ [mount](https://man7.org/linux/man-pages/man2/mount.2.html) and [chroot](https://man7.org/linux/man-pages/man2/chroot.2.html): Created an isolated file system
+ [setrlimit](https://man7.org/linux/man-pages/man2/getrlimit.2.html): Set resource limits (stack size)
+ [setuid](https://man7.org/linux/man-pages/man2/setuid.2.html) and [setgid](https://man7.org/linux/man-pages/man2/setuid.2.html): Run submission under another user and group
+ [ptrace](https://man7.org/linux/man-pages/man2/ptrace.2.html): Filter submission syscall

> **Note**
>
> To enable all of above features, it is highly recommended to use it under the **root** user, otherwise it may fall back automatically.

## Installation

```bash
# Install using cargo
$ cargo install catj

# Check installation
$ catj --version

# Init cgroup for current user
$ ./init.sh $USER
```

## Usage

```bash
# Compile C++ source code
$ catj compile ./fixtures/aplusb/source/ac.cpp -o a.out

# Run a.out
$ catj run --stdin ./fixtures/aplusb/testcases/1.in -- ./a.out

# Generate report
$ catj --report run --stdin ./fixtures/aplusb/testcases/1.in --stdout ./sub.out -- ./a.out
```

## License

MIT License © 2023 [XLor](https://github.com/yjl9903)