view MoinMoin/server/ @ 3102:a78bf6977df8

removed 'logging initialized' message because it filled the logs for CGI (ported from 1.6)
author Thomas Waldmann <tw AT waldmann-edv DOT de>
date Sat, 23 Feb 2008 16:14:04 +0100
parents cfdb0ffc2910
children 80e1a910a2f1
line wrap: on
line source

# -*- coding: iso-8859-1 -*-
    MoinMoin server package

    Supply common server utilities.

    @copyright: 2004 Nir Soffer
    @license: GNU GPL, see COPYING for details.

import os
import logging

from MoinMoin import config

def switchUID(uid, gid):
    """ Switch identity to safe user and group

    Does not support Windows, because the necessary calls are not available.
    TODO: can we use win32api calls to achieve the same effect on Windows?

    Raise RuntimeError if can't switch or trying to switch to root.
    if uid == 0 or gid == 0:
        # We will not run as root. If you like to run a web
        # server as root, then hack this code.
        raise RuntimeError('will not run as root!')

    except (OSError, AttributeError):
        # Either we can't switch, or we are on windows, which does not have
        # those calls.
        raise RuntimeError("can't change uid/gid to %s/%s" %
                           (uid, gid))"Running as uid/gid %d/%d" % (uid, gid))

class Config:
    """ Base class for server configuration

    When you create a server, you should run it with a Config
    instance. Sub class to define the default values.

    This class does all error checking needed for config values, and will
    raise a RuntimeError on any fatal error.
    # some defaults that should be common for all servers:
    url_prefix_static = config.url_prefix_static
    docs = None # document root (if supported)
    user = None # user we shall use for running (if supported)
    group = None # group ...
    port = None # tcp port number (if supported)

    # log levels for different log handlers
    # None means "don't use this handler", otherwise specify the minimum loglevel, e.g. logging.DEBUG
    # TODO: change later to an appropriate level, for now, we want everything
    loglevel_file = logging.DEBUG # None
    loglevel_stderr = logging.DEBUG # None
    logPath = None

    def __init__(self):
        """ Validate and post process configuration values

        Will raise RuntimeError for any wrong config value.
        # First, initialize the logging
        logger = logging.getLogger('') # root logger
        logger.setLevel(logging.NOTSET) # otherwise it has WARNING by default!

        if self.loglevel_file is not None and self.logPath is not None:
            # define a Handler which writes to a log file
            logfile = logging.FileHandler(self.logPath, 'at') # XXX we can't say ", 0" for sync here :(
            # set a format which is better for logfile use
            formatter = logging.Formatter('%(asctime)s %(levelname)s %(message)s')
            # tell the handler to use this format
            # add the handler to the root logger

        if self.loglevel_stderr is not None:
            # define a Handler which writes INFO to sys.stderr
            logstderr = logging.StreamHandler()
            # set a format which is simpler for console use
            formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s', '%H%M%S')
            # tell the handler to use this format
            # add the handler to the root logger

        # Check that docs path is accessible
   = os.path.normpath(os.path.abspath(
            if not os.access(, os.F_OK | os.R_OK | os.X_OK):
                raise RuntimeError("Can't access docs directory '%s'. Check docs "
                                   "setting and permissions." %

        # Don't check uid and gid on windows, those calls are not available.
        if == 'nt':
            self.uid = self.gid = 0

        self.uid = os.getuid()
        self.gid = os.getgid()

        # If serving privileged port, we must run as root to bind the port.
        # we will give up root privileges later
        if self.port and self.port < 1024 and self.uid != 0:
            raise RuntimeError('Must run as root to serve port number under 1024. '
                               'Run as root or change port setting.')

        if self.user and and self.uid == 0:
            # If we run as root to serve privileged port, we change user and group
            # to a safe setting. Get the uid and gid now, switch later.
            import pwd, grp
                self.uid = pwd.getpwnam(self.user)[2]
            except KeyError:
                raise RuntimeError("Unknown user: '%s', check user setting" % self.user)
                self.gid = grp.getgrnam([2]
            except KeyError:
                raise RuntimeError("Unknown group: '%s', check group setting" %