o b>@sddlZddlZddlZddlZddlZddlmZmZddlm Z m Z ddl m Z ddl mZmZmZddlmZddlmZmZmZmZedkrNed d d ZGd d d e jZddZGddde jZddZGddde jZ dS)N) copyrightlogger)appservice)IReactorDaemonize)loglogfileusage) platformType) gidFromString switchUID uidFromStringuntilConcludeswin32z%_twistd_unix doesn't work on Windows.cCs t|dS)N)int)valuer>/usr/lib/python3/dist-packages/twisted/scripts/_twistd_unix.py_umasks rc @seZdZdZgdgdgdgdgZgdgdgdd d d d egd dd degdd d deggZe j e de j dde j dde jdde jddddZddZddZd S) ServerOptionszUsage: twistd [options])nodaemonnz0don't daemonize, don't use default umask of 0077) originalnameNz$Don't try to change the process name)syslogNzLog to syslog, not to file)euidaSet only effective user-id rather than real user-id. (This option has no effect unless the server is running as root, in which case it means not to shed all privileges after binding ports, retaining the option to regain privileges in cases such as spawning processes. Use with caution.))prefixNtwistedz$use the given prefix when syslogging)pidfilerz twistd.pidzName of the pidfile)chrootNNz-Chroot to a supplied directory before runninguiduNzThe uid to run as.gidgzbThe gid to run as. If not specified, the default gid associated with the specified --uid is used.umaskz(The (octal) file creation mask to apply.z*.pidzchroot directory)descrz gid to run asz uid to run asz syslog prefix)rr r#r!r) optActionscCs2tdtj|jdttj|jdtdS)z5 Print version information and exit. ztwistd (the Twisted daemon) )fileN)printrversionstdoutsysexitselfrrr opt_versionHs zServerOptions.opt_versioncCs0tj||drtj|d|d<dSdS)Nr)rr postOptionsospathabspathr.rrrr1Ps zServerOptions.postOptions)__name__ __module__ __qualname__synopsisoptFlagsr r r optParametersr Completions CompleteFiles CompleteDirsCompleteGroupsCompleteUsernames CompletercompDatar0r1rrrrrs:       rc Cs|sdStj|rzt|}t|}Wdn1s wYWnty8td|dYnwzt |dWn:t y{}z.|j t j kr_t jd|ddt|ntd|||WYd}~dSWYd}~dSd}~wwtd|dSdS) NzPidfile z contains non-numeric valuerzRemoving stale pidfile T)isErrorz0Can't check status of PID {} from pidfile {}: {}aAnother twistd server is running, PID {} This could either be a previously started instance of your application or a different application entirely. To start a new one, either run it in some other directory, or use the --pidfile and --logfile parameters to avoid clashes. )r2r3existsopenrread ValueErrorr,r-killOSErrorerrnoESRCHrmsgremoveformat)rfpidwhyrrrcheckPIDVs@      rQc@s eZdZdZddZddZdS) UnixAppLoggera A logger able to log to syslog, to files, and to stdout. @ivar _syslog: A flag indicating whether to use syslog instead of file logging. @type _syslog: C{bool} @ivar _syslogPrefix: If C{sysLog} is C{True}, the string prefix to use for syslog messages. @type _syslogPrefix: C{str} @ivar _nodaemon: A flag indicating the process will not be daemonizing. @type _nodaemon: C{bool} cCs<tj|||dd|_|dd|_|dd|_dS)NrFrrr)r AppLogger__init__get_syslog _syslogPrefix _nodaemon)r/optionsrrrrTszUnixAppLogger.__init__cs|jrddlm}||jjS|jdkr!|jst dtj n:|jr+|js+tj n0|js1d|_t j |jzddl}Wn tyGYnw||js[fdd}||j|tS) a Create and return a suitable log observer for the given configuration. The observer will go to syslog using the prefix C{_syslogPrefix} if C{_syslog} is true. Otherwise, it will go to the file named C{_logfilename} or, if C{_nodaemon} is true and C{_logfilename} is C{"-"}, to stdout. @return: An object suitable to be passed to C{log.addObserver}. r)r-z&Daemons cannot log to stdout, exiting!z twistd.logNcsddlm}|jdS)Nrreactor)twisted.internetr\callFromThreadrotate)signalframer\logFilerr rotateLogs z0UnixAppLogger._getLogObserver..rotateLog)rVtwisted.pythonrSyslogObserverrWemit _logfilenamerXr,r-r+rLogFile fromFullPathr` ImportError getsignalSIGUSR1rtextFileLogObserver)r/rr`rdrrbr_getLogObservers*         zUnixAppLogger._getLogObserverN)r5r6r7__doc__rTrorrrrrRys rRcCs`|r,|tjdkr.tjtj}td|t||tjddgtjdddSdSdS)NrzChanging process name to z--originalname) r,argvr2r3realpath executablerrKexecv)nameexerrrlaunchWithNames *rxc@sfeZdZdZeZddZddZddZdd Z d d Z d d Z de de fddZ ddZddZdS)UnixApplicationRunnerzx An ApplicationRunner which does Unix-specific things, like fork, shed privileges, and maintain a PID file. cCs<t|jd|jdp|jd|jd<tj|_tj|_dS)z4 Do pre-application-creation setup. rrdebugN)rQconfigr,r+ oldstdoutstderr oldstderrr.rrrpreApplications z$UnixApplicationRunner.preApplicationcCs8t|j|d}d|}|dd}|ddS)aC Format the C{exception} in preparation for writing to the status pipe. This does the right thing on Python 2 if the exception's message is Unicode, and in all cases limits the length of the message afte* encoding to 100 bytes. This means the returned message may be truncated in the middle of a unicode escape. @type exception: L{Exception} @param exception: The exception to format. @return: The formatted message, suitable for writing to the status pipe. @rtype: L{bytes} z1 asciibackslashreplaceNd) tracebackformat_exception_only __class__stripencode)r/ exception exceptionLineformattedMessagerrr_formatChildExceptions   z+UnixApplicationRunner._formatChildExceptionc Csz||jWn2ty:}z&|jdd}|dur-||}ttj||ttj || |jdd}~ww|jdd}|durSttj|dttj || d|j |j | |jddS)z To be called after the application is created: start the application and run the reactor. After the reactor stops, clean up PID files and such. statusPipeNr0)startApplication application Exceptionr{rUrrr2writeclose removePID startReactorr|r~)r/exrmessagerrrpostApplications$    z%UnixApplicationRunner.postApplicationc Cs|sdSzt|WdSty>}z&|jtjks |jtjkr&tdn t|dWYd}~dSWYd}~dSd}~wt yMtddYdSw)z Remove the specified PID file, if possible. Errors are logged, not raised. @type pidfile: C{str} @param pidfile: The path to the PID tracking file. Nz)Warning: No permission to delete pid filezFailed to unlink PID file:) r2unlinkrHrIEACCESEPERMrrKerr BaseException)r/rerrrrs  zUnixApplicationRunner.removePIDc Cs| }|durt||dkrd}t||r|durd}|dur(t||r8ddlm}|||jd<|r\t|d}| d t fWddS1sUwYdSdS) a Set the filesystem root, the working directory, and daemonize. @type chroot: C{str} or L{None} @param chroot: If not None, a path to use as the filesystem root (using L{os.chroot}). @type rundir: C{str} @param rundir: The path to set as the working directory. @type nodaemon: C{bool} @param nodaemon: A flag which, if set, indicates that daemonization should not be done. @type umask: C{int} or L{None} @param umask: The value to which to change the process umask. @type pidfile: C{str} or L{None} @param pidfile: If not L{None}, the path to a file into which to put the PID of this process. N./?rr[rwbs%d) r2r chdirr%r]r\ daemonizer{rDrgetpid) r/r rundirrr%rdaemonr\rNrrrsetupEnvironment#s$      "z&UnixApplicationRunner.setupEnvironmentc Cst|r |t\}}tr"||}t|t|t tr/tdt dtj }t dD]#}zt ||Wq:ty]}z |jtjkrSWYd}~q:d}~wwt|t|rl||S)a7 Daemonizes the application on Unix. This is done by the usual double forking approach. @see: U{http://code.activestate.com/recipes/278731/} @see: W. Richard Stevens, "Advanced Programming in the Unix Environment", 1992, Addison-Wesley, ISBN 0-201-56317-7 @param reactor: The reactor in use. If it provides L{IReactorDaemonize}, its daemonization-related callbacks will be invoked. @return: A writable pipe to be used to report errors. @rtype: C{int} rz /dev/nullN)r providedBybeforeDaemonizer2pipefork _waitForStartr_exitsetsidrDO_RDWRrangedup2rHrIEBADFafterDaemonize)r/r\rwcodenullirrrrrLs0           zUnixApplicationRunner.daemonizereadPipereturncCsFttj|d}t|dd}|dkr!d|}ttjj|dSdS)a Wait for the daemonization success. @param readPipe: file descriptor to read start information from. @type readPipe: C{int} @return: code to be passed to C{os._exit}: 0 for success, 1 for error. @rtype: C{int} rNrzHAn error has occurred: {} Please look at log file for more information. rqr)rr2rEreprrMr, __stderr__r)r/rdatadataReprrKrrrrxs z#UnixApplicationRunner._waitForStartc Cs|dus|durO|r dp d}|d|d|d|}zt|||Wn!tyD}ztd||tdWYd}~dSd}~wwtd |dSdS) a Change the UID and GID or the EUID and EGID of this process. @type euid: C{bool} @param euid: A flag which, if set, indicates that only the I{effective} UID and GID should be set. @type uid: C{int} or L{None} @param uid: If not L{None}, the UID to which to switch. @type gid: C{int} or L{None} @param gid: If not L{None}, the GID to which to switch. Nrrzuid/zgid rz0failed to set {}: {} (are you root?) -- exiting.rqzset )r rHrrKrMr,r-)r/rr!r#extradescrrrrshedPrivilegess z$UnixApplicationRunner.shedPrivilegescCst|}|jdst|j||jd|jd|jd|jd|jdt||jd|jd}}|d ur@|j}|d urG|j }|d urU|d urUt |j }| |jd ||t||jd  d S) z Configure global process state based on the given application and run the application. @param application: An object which can be adapted to L{service.IProcess} and L{service.IService}. rr rrr%rr!r#Nrno_save)rIProcessr{rx processNamerIServiceprivilegedStartServicer!r#pwdgetpwuidpw_gidrrr)r/rprocessr!r#rrrrs(    z&UnixApplicationRunner.startApplicationN)r5r6r7rprR loggerFactoryrrrrrrrrrrrrrrrys %), ry)!rIr2rr,rrrrtwisted.applicationrrtwisted.internet.interfacesrrerrr twisted.python.runtimer twisted.python.utilr r r rrkrrrQrSrRrxApplicationRunnerryrrrrs&  ;#A