Skip to content

Commit 594c041

Browse files
Barb CutlerBarb Cutler
authored andcommitted
updates
1 parent e3ba92e commit 594c041

File tree

1 file changed

+17
-4
lines changed

1 file changed

+17
-4
lines changed

_docs/instructor/autograding/system_call_filtering.md

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,22 @@ The current categories and lists of calls within each category can be
2929
inspected in the Submitty source code:
3030
[grading/system_call_categories.cpp](https://github.com/Submitty/Submitty/blob/main/grading/system_call_categories.cpp)
3131

32+
When an gradeable autograding configuration is built, we detect the
33+
programs that will be run and attempt to automatically select an
34+
appropriate list of system call categories to allow by default.
35+
Hopefully, for common programming languages and most typical
36+
autograding tasks, this default category list is suitable and the
37+
autograding configuration written by the instructor does not need to
38+
adjust or override these settings. But in cases where these defaults
39+
are not sufficient, the instructor can override these default
40+
settings.
41+
3242

3343
### What system calls are used by a specific program?
3444

3545
The GNU/Linux [strace](https://strace.io/) utility can be used to
3646
collect all system calls made in a run of a program. First, install
37-
strace on your machine.
47+
strace on your machine:
3848

3949
```
4050
sudo apt-get install strace
@@ -109,15 +119,14 @@ You can just copy paste that into your `config.json` either at the
109119
global level, or per test case.
110120

111121
Alternately, you can simply enable all system calls that are in
112-
*restricted* category:
122+
a *restricted* Submitty system call category:
113123

114124
```
115125
"allow_system_calls" : [ "ALLOW_ALL_RESTRICTED_SYSTEM_CALLS" ],
116126
```
117127

118128
Again, this can be set at the global level or per-test case.
119129

120-
121130
An example autograding configuration using the `"allow_system_calls"`
122131
syntax is here:
123132

@@ -149,4 +158,8 @@ Students who see this message should first review the programming
149158
assignment instructions and confirm they have followed detailed
150159
instructions about resources and techniques that are allowed. Only
151160
the instructor for the course can modify the list of system calls that
152-
are allowed for autograding that assignment.
161+
are allowed for autograding that assignment.
162+
163+
164+
See also:
165+
[Autograding Configuration Structure](/instructor/autograding/structure)

0 commit comments

Comments
 (0)