summaryrefslogtreecommitdiff
path: root/include/usage.h
diff options
context:
space:
mode:
authorDenis Vlasenko2006-10-03 15:57:40 +0000
committerDenis Vlasenko2006-10-03 15:57:40 +0000
commitfe54458e46eef445da32862b2171392be8f01ab4 (patch)
treef88b5ee99da5816f1628c9560cfabecb97468689 /include/usage.h
parent7c1ed2e922e80b7a81da3e748cb975c876315bd5 (diff)
downloadbusybox-fe54458e46eef445da32862b2171392be8f01ab4.zip
busybox-fe54458e46eef445da32862b2171392be8f01ab4.tar.gz
runit/chpst: "change process state" utility
It's "nice" on steroids - can set uid/gid, mem/cpu limits etc. +3.5k
Diffstat (limited to 'include/usage.h')
-rw-r--r--include/usage.h64
1 files changed, 64 insertions, 0 deletions
diff --git a/include/usage.h b/include/usage.h
index 40676c1..34b0566 100644
--- a/include/usage.h
+++ b/include/usage.h
@@ -215,6 +215,70 @@
"ls -l /tmp/foo\n" \
"-r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo\n"
+#define chpst_trivial_usage \
+ "[-vP012] [-u user[:group]] [-U user[:group]] [-e dir] " \
+ "[-/ dir] [-n nice] [-m bytes] [-d bytes] [-o files] " \
+ "[-p processes] [-f bytes] [-c bytes] prog args"
+#define chpst_full_usage \
+ "Change the process state and run specified program.\n\n" \
+ "-u user[:grp] set uid and gid\n" \
+ "-U user[:grp] set environment variables UID and GID\n" \
+ "-e dir set environment variables as specified by files\n" \
+ " in the directory: file=1st_line_of_file\n" \
+ "-/ dir chroot to dir\n" \
+ "-n inc add inc to nice value\n" \
+ "-m bytes limit data segment, stack segment, locked physical pages,\n" \
+ " and total of all segment per process to bytes bytes each\n" \
+ "-d bytes limit data segment\n" \
+ "-o n limit the number of open file descriptors per process to n\n" \
+ "-p n limit number of processes per uid to n\n" \
+ "-f bytes limit output file size to bytes bytes\n" \
+ "-c bytes limit core file size to bytes bytes\n" \
+ "-v verbose\n" \
+ "-P run prog in a new process group\n" \
+ "-0 close standard input\n" \
+ "-1 close standard output\n" \
+ "-2 close standard error"
+#define setuidgid_trivial_usage \
+ "account prog args"
+#define setuidgid_full_usage \
+ "Sets uid and gid to account's uid and gid, removing all supplementary\n" \
+ "groups, then runs prog"
+#define envuidgid_trivial_usage \
+ "account prog args"
+#define envuidgid_full_usage \
+ "Sets $UID to account's uid and $GID to account's gid, then runs prog"
+#define envdir_trivial_usage \
+ "dir prog args"
+#define envdir_full_usage \
+ "Sets various environment variables as specified by files\n" \
+ "in the directory dir, then runs prog"
+#define softlimit_trivial_usage \
+ "[-a allbytes] [-c corebytes] [-d databytes] [-f filebytes] " \
+ "[-l lockbytes] [-m membytes] [-o openfiles] [-p processes] " \
+ "[-r residentbytes] [-s stackbytes] [-t cpusecs] prog args"
+#define softlimit_full_usage \
+ "Sets soft resource limits as specified by options, then runs prog\n" \
+ "\n" \
+ "-m n Same as -d n -s n -l n -a n\n" \
+ "-d n Limit the data segment per process to n bytes\n" \
+ "-s n Limit the stack segment per process to n bytes\n" \
+ "-l n Limit the locked physical pages per process to n bytes\n" \
+ "-a n Limit the total of all segments per process to n bytes\n" \
+ "-o n Limit the number of open file descriptors per process to n\n" \
+ "-p n Limit the number of processes per uid to n\n" \
+ "Options controlling file sizes:\n" \
+ "-f n Limit output file sizes to n bytes\n" \
+ "-c n Limit core file sizes to n bytes\n" \
+ "Efficiency opts:\n" \
+ "-r n Limit the resident set size to n bytes. This limit is not\n" \
+ " enforced unless physical memory is full\n" \
+ "-t n Limit the CPU time to n seconds. This limit is not enforced\n" \
+ " except that the process receives a SIGXCPU signal after n seconds\n" \
+ "\n" \
+ "Some options may have no effect on some operating systems\n" \
+ "n may be =, indicating that soft limit should be set equal to hard limit"
+
#define chroot_trivial_usage \
"NEWROOT [COMMAND...]"
#define chroot_full_usage \