@@ -29,12 +29,22 @@ The current categories and lists of calls within each category can be
29
29
inspected in the Submitty source code:
30
30
[ grading/system_call_categories.cpp] ( https://github.com/Submitty/Submitty/blob/main/grading/system_call_categories.cpp )
31
31
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
+
32
42
33
43
### What system calls are used by a specific program?
34
44
35
45
The GNU/Linux [ strace] ( https://strace.io/ ) utility can be used to
36
46
collect all system calls made in a run of a program. First, install
37
- strace on your machine.
47
+ strace on your machine:
38
48
39
49
```
40
50
sudo apt-get install strace
@@ -109,15 +119,14 @@ You can just copy paste that into your `config.json` either at the
109
119
global level, or per test case.
110
120
111
121
Alternately, you can simply enable all system calls that are in
112
- * restricted* category:
122
+ a * restricted* Submitty system call category:
113
123
114
124
```
115
125
"allow_system_calls" : [ "ALLOW_ALL_RESTRICTED_SYSTEM_CALLS" ],
116
126
```
117
127
118
128
Again, this can be set at the global level or per-test case.
119
129
120
-
121
130
An example autograding configuration using the ` "allow_system_calls" `
122
131
syntax is here:
123
132
@@ -149,4 +158,8 @@ Students who see this message should first review the programming
149
158
assignment instructions and confirm they have followed detailed
150
159
instructions about resources and techniques that are allowed. Only
151
160
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