From d49c786a6bd31c3063eda9363accb20724a3af87 Mon Sep 17 00:00:00 2001 From: nikhil Date: Wed, 14 Oct 2020 13:58:27 +0530 Subject: [PATCH 1/5] sstat: add page --- pages/linux/sstat.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 pages/linux/sstat.md diff --git a/pages/linux/sstat.md b/pages/linux/sstat.md new file mode 100644 index 0000000000000..ae188651d379a --- /dev/null +++ b/pages/linux/sstat.md @@ -0,0 +1,16 @@ +# sstat + +> View information about running jobs. +> More information: . + +- Show status information for job: + +`sstat --jobs={{job_id}}` + +- Show selected information with pipes as column delimiters: + +`sstat --parsable --jobs={{job_id}} --format={{comma separated field list}}` + +- Show list of fields available: + +`sstat --helpformat` From 7cb66d456ca65673f626d405c84b1073d84c606c Mon Sep 17 00:00:00 2001 From: nikhil Date: Wed, 14 Oct 2020 14:13:15 +0530 Subject: [PATCH 2/5] scontrol: add page --- pages/linux/scontrol.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 pages/linux/scontrol.md diff --git a/pages/linux/scontrol.md b/pages/linux/scontrol.md new file mode 100644 index 0000000000000..fd83519842280 --- /dev/null +++ b/pages/linux/scontrol.md @@ -0,0 +1,24 @@ +# scontrol + +> View information about running jobs. +> More information: . + +- Show information for job: + +`scontrol show job {{job_id}}` + +- Suspend a running job: + +`scontrol suspend {{job_id}}` + +- Resume a suspended job: + +`scontrol resume {{job_id}}` + +- Hold a queued job (gives it least priority): + +`scontrol hold {{job_id}}` + +- Release a held job: + +`scontrol release {{job_id}}` From fa382389eed05b5df0b2a0bd25f539991fe3d467 Mon Sep 17 00:00:00 2001 From: Nikhil Reddy <35285981+npalladium@users.noreply.github.com> Date: Wed, 14 Oct 2020 16:48:41 +0530 Subject: [PATCH 3/5] Apply suggestions from code review Co-authored-by: Axel Navarro --- pages/linux/scontrol.md | 4 ++-- pages/linux/sstat.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/pages/linux/scontrol.md b/pages/linux/scontrol.md index fd83519842280..70588f8232221 100644 --- a/pages/linux/scontrol.md +++ b/pages/linux/scontrol.md @@ -1,13 +1,13 @@ # scontrol -> View information about running jobs. +> View information and modify running jobs. > More information: . - Show information for job: `scontrol show job {{job_id}}` -- Suspend a running job: +- Suspend a comma-separated list of running job: `scontrol suspend {{job_id}}` diff --git a/pages/linux/sstat.md b/pages/linux/sstat.md index ae188651d379a..2f5d523f107b8 100644 --- a/pages/linux/sstat.md +++ b/pages/linux/sstat.md @@ -3,13 +3,13 @@ > View information about running jobs. > More information: . -- Show status information for job: +- Display status information of a comma-separated list of jobs: `sstat --jobs={{job_id}}` -- Show selected information with pipes as column delimiters: +- Display job ID, average CPU and average virtual memory size of a comma-separated list of jobs, with pipes as column delimiters: -`sstat --parsable --jobs={{job_id}} --format={{comma separated field list}}` +`sstat --parsable --jobs={{job_id}} --format={{JobID}},{{AveCPU}},{{AveVMSize}}` - Show list of fields available: From 7247c4559819cb0de2d16537fcf4cf2d7f39a547 Mon Sep 17 00:00:00 2001 From: Nikhil Reddy <35285981+npalladium@users.noreply.github.com> Date: Wed, 14 Oct 2020 16:51:29 +0530 Subject: [PATCH 4/5] Update scontrol.md --- pages/linux/scontrol.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/linux/scontrol.md b/pages/linux/scontrol.md index 70588f8232221..8deae660fbc5a 100644 --- a/pages/linux/scontrol.md +++ b/pages/linux/scontrol.md @@ -1,6 +1,6 @@ # scontrol -> View information and modify running jobs. +> View information about and modify jobs. > More information: . - Show information for job: From 8e33d64220834b775a4d8a5a272fa4d3783bf080 Mon Sep 17 00:00:00 2001 From: Nikhil Reddy <35285981+npalladium@users.noreply.github.com> Date: Wed, 14 Oct 2020 17:24:25 +0530 Subject: [PATCH 5/5] Apply suggestions from code review Co-authored-by: Axel Navarro --- pages/linux/scontrol.md | 10 +++++----- pages/linux/sstat.md | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/pages/linux/scontrol.md b/pages/linux/scontrol.md index 8deae660fbc5a..c1cc94b9d5742 100644 --- a/pages/linux/scontrol.md +++ b/pages/linux/scontrol.md @@ -7,18 +7,18 @@ `scontrol show job {{job_id}}` -- Suspend a comma-separated list of running job: +- Suspend a comma-separated list of running jobs: `scontrol suspend {{job_id}}` -- Resume a suspended job: +- Resume a comma-separated list of suspended jobs: `scontrol resume {{job_id}}` -- Hold a queued job (gives it least priority): +- Hold a comma-separated list of queued jobs (Use `release` command to permit the jobs to be scheduled): `scontrol hold {{job_id}}` -- Release a held job: +- Release a comma-separated list of suspended job: -`scontrol release {{job_id}}` +`scontrol release {{job_id}}` diff --git a/pages/linux/sstat.md b/pages/linux/sstat.md index 2f5d523f107b8..278b0b256e5bd 100644 --- a/pages/linux/sstat.md +++ b/pages/linux/sstat.md @@ -11,6 +11,6 @@ `sstat --parsable --jobs={{job_id}} --format={{JobID}},{{AveCPU}},{{AveVMSize}}` -- Show list of fields available: +- Display list of fields available: `sstat --helpformat`