@@ -29,12 +29,22 @@ The current categories and lists of calls within each category can be
2929inspected 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
3545The GNU/Linux [ strace] ( https://strace.io/ ) utility can be used to
3646collect all system calls made in a run of a program. First, install
37- strace on your machine.
47+ strace on your machine:
3848
3949```
4050sudo apt-get install strace
@@ -109,15 +119,14 @@ You can just copy paste that into your `config.json` either at the
109119global level, or per test case.
110120
111121Alternately, 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
118128Again, this can be set at the global level or per-test case.
119129
120-
121130An example autograding configuration using the ` "allow_system_calls" `
122131syntax is here:
123132
@@ -149,4 +158,8 @@ Students who see this message should first review the programming
149158assignment instructions and confirm they have followed detailed
150159instructions about resources and techniques that are allowed. Only
151160the 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