| Summary: | SCHED_DEADLINE missing from 'sched_setscheduler' man page | ||
|---|---|---|---|
| Product: | [Fedora] Fedora | Reporter: | Daniel Berrangé <berrange> |
| Component: | man-pages | Assignee: | Nikola Forró <nforro> |
| Status: | CLOSED ERRATA | QA Contact: | Fedora Extras Quality Assurance <extras-qa> |
| Severity: | unspecified | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | 25 | CC: | jchaloup, mtk.manpages, nforro |
| Target Milestone: | --- | ||
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | man-pages-4.06-3.fc25 | Doc Type: | If docs needed, set a value |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2016-12-15 23:32:08 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
Ok, it turns out that you can't use SCHED_DEADLINE in combination with sched_setschedular, because you need to provide various attributes atomically with the setting of the schedular. Thus you must use sched_setattr instead. It would be desirable for the sched_setaffinity to direct devs to the sched_setattr method for SCHED_DEADLINE, rather than just pretending it doesn't exist. > It would be desirable for the sched_setaffinity to direct devs to the s/sched_setaffinity/sched_setscheduler/ (presumably). > sched_setattr method for SCHED_DEADLINE, rather than just pretending it > doesn't exist. I'd encourage you to think a little about your phrasing. No one/nothing is "pretending" anything. To phase it that way carries rather negative connotations. Anyway, for upstream man-pages-4.09, I have applied the following patch. Thanks, Michael --- a/man2/sched_setscheduler.2 +++ b/man2/sched_setscheduler.2 @@ -171,8 +171,13 @@ POSIX.1-2001, POSIX.1-2008 (but see BUGS below). The \fBSCHED_BATCH\fP and \fBSCHED_IDLE\fP policies are Linux-specific. .SH NOTES Further details of the semantics of all of the above "normal" -and "real-time" scheduling policies can be found in -.BR sched (7). +and "real-time" scheduling policies can be found in the +.BR sched (7) +manual page. +That page also describes an additional policy, +.BR SCHED_DEADLINE , +which is settable only via +.BR sched_setattr (2). POSIX systems on which .BR sched_setscheduler () Thanks Michael, patch backported to F25: http://pkgs.fedoraproject.org/cgit/rpms/man-pages.git/commit/?h=f25&id=fe6a825e32e452212a31c8d6c9b4a8c270ff84ad man-pages-4.06-3.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2016-b7694f007e man-pages-4.06-3.fc25 has been pushed to the Fedora 25 testing repository. If problems still persist, please make note of it in this bug report. See https://fedoraproject.org/wiki/QA:Updates_Testing for instructions on how to install test updates. You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2016-b7694f007e man-pages-4.06-3.fc25 has been pushed to the Fedora 25 stable repository. If problems still persist, please make note of it in this bug report. man-pages-4.06-3.fc25 has been pushed to the Fedora 25 stable repository. If problems still persist, please make note of it in this bug report. |
Description of problem: /usr/include/linux/sched.h listed 6 scheduler constants #define SCHED_NORMAL 0 #define SCHED_FIFO 1 #define SCHED_RR 2 #define SCHED_BATCH 3 /* SCHED_ISO: reserved but not implemented yet */ #define SCHED_IDLE 5 #define SCHED_DEADLINE 6 but 'man sched_setscheduler' only lists 5 of them SCHED_OTHER the standard round-robin time-sharing policy; SCHED_BATCH for "batch" style execution of processes; and SCHED_IDLE for running very low priority background jobs. SCHED_FIFO a first-in, first-out policy; and SCHED_RR a round-robin policy. It is missing SCHED_DEADLINE Version-Release number of selected component (if applicable): man-pages-4.06-2.fc25.noarch