STAP-SERVER(8) System Manager's Manual STAP-SERVER(8) (NAME) stap-server - systemtap (SYNOPSIS) [ service ] stap-server { start | stop | restart | condrestart | try-restart | force-reload | status } [ ] (DESCRIPTION) systemtap SSL stap stap . mDNS (avahi) . stap-server : o systemtap . o ( ad-hoc). (ARGUMENTS) : start . . . . . . stop (). . . . . restart . . . start . condrestart . . . . . try-restart condrestart . force-reload start . status . () . . (OPTIONS) : -c configfile . . -c . -a architecture -a stap . stap(1) . . -r kernel-release -r stap . stap(1) . . -r . -I path (tapsets) () -I stap . stap(1) . -R path (runtime) systemtap () -R stap . stap(1) . -B options systemtap make -B stap . stap(1) . -i /lib/modules/ . -n nickname (nickname) . -n . -c . -a -r -I -R -B -u . start ( start (ARGUMENTS) ) . start ( start) . (PID) . -p pid (process id) . -p . . -a -r -I -R -B -u . -u user-name systemtap stap-server ( initscript) stap-server ( (FILES) ). () . stap-server . --log logfile . --log . --log ( (FILES) ) . --port port-number () . --port . --port . --ssl certificate-db-path NSS . --ssl . --ssl ( (FILES) ) . --max-threads threads (worker threads) . threads == 0 . . --max-request-size size . size . . --max-compressed-request size . size . . (CONFIGURATION) : o . o . (GLOBAL CONFIGURATION) . '#' . VARIABLE=VALUE . . = . : CONFIG_PATH . STAT_PATH . LOG_FILE . STAP_USER (userid) () (: initscript stap-server stap-server ). : CONFIG_PATH=~/my-stap-server-configs LOG_FILE=/tmp/stap-server/log (INDIVIDUAL SERVER CONFIGURATION) start start ( (ARGUMENTS) ). . '#' . VARIABLE=VALUE . . = . .conf . stappaths(7) . -c ( (OPTIONS) ). : ARCH -a ( (OPTIONS) ). ARCH . RELEASE -r ( (OPTIONS) ). RELEASE . BUILD make systemtap . -B ( (OPTIONS) ). BUILD=STRING STRING . BUILD+=STRING STRING . INCLUDE . -I ( (OPTIONS) ). INCLUDE=PATH PATH . INCLUDE+=PATH PATH . RUNTIME systemtap -R ( (OPTIONS) ). USER -u ( (OPTIONS) ). NICKNAME -n ( (OPTIONS) ). LOG --log ( (OPTIONS) ). PORT --port ( (OPTIONS) ). SSL NSS --ssl ( (OPTIONS) ). MAXTHREADS --max-threads ( (OPTIONS) ). MAXREQSIZE --max-request-size ( (OPTIONS) ). MAXCOMPRESSEDREQ --max-compressed-request ( (OPTIONS) ). : ARCH= USER= RELEASE= NICKNAME=native ARCH USER RELEASE . : ARCH=i386 RELEASE=2.6.18-128.el5 PORT=5001 LOG=/path/to/log/file : USER=serveruser RELEASE=/kernels/2.6.18-92.1.18.el5/build INCLUDE=/mytapsets INCLUDE+=/yourtapsets BUILD='VARIABLE1=VALUE1 VARIABLE2=VALUE2' DEFINE=STP_MAXMEMORY=1024 DEFINE+=DEBUG_TRANS RUNTIME=/myruntime NICKNAME=my-server SSL=/path/to/NSS/certificate/database (SERVER AUTHENTICATION) SSL . systemtap (CA) systemtap . . . (initscript) stap-server . systemtap-server (stap-server) . initscript stap-server SSL systemtap . stap ( root stapdev stapusr stapsys) --use-server --privilege . . ( SystemTap ) --use-server --privilege ( -p4 ). . --trust-servers stap(1) README.unprivileged systemtap . (EXAMPLES) systemtap stapex(3stap) . : $ [ service ] stap-server start /lib/modules : $ [ service ] stap-server start -i () : $ [ service ] stap-server status : $ [ service ] stap-server start -n NICKNAME -a ARCH ( cross-compiling): $ [ service ] stap-server start -a ARCH -r /BUILDDIR ( stap-server status): $ [ service ] stap-server stop -p PID : $ stap SCRIPT --use-server : $ stap SCRIPT : $ [ service ] stap-server stop / : $ [ service ] stap-server force-reload (SAFETY AND SECURITY) Systemtap . . stap(1) . stap-server . : 1 stap-server (root). ( service stap-server ...) stap-server . ( stap-server ...) . -u STAP_USER=username USER=username . . (CONFIGURATION) . . LOG_FILE=path . (CONFIGURATION) . / . STAT_PATH=path . (CONFIGURATION) . / uprobes.ko . root stap-server . 2 stap-server (CPU time) . stap-server ~stap-server/.systemtap/rc . 3 stap-server TMPDIR / (quota) . TMPDIR /tmp/ . 4 stap . avahi mDNS . systemtap (SSL) Network Security Services (NSS) . NSS . . . systemtap . (FILES) stappaths(7) . (SEE ALSO) stap(1), staprun(8), stapprobes(3stap), stappaths(7), stapex(3stap), avahi, ulimit(1), NSS (BUGS) (Bugzilla) : http://sourceware.org/systemtap, . STAP-SERVER(8)