summaryrefslogtreecommitdiff
path: root/sphinx/source/refman/process/plugins/dropprivileges.rst
blob: 5eab333781dd0b47ec1ab33acd3aa44bb0c1eac0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
***************
Drop privileges
***************

Use this :ref:`Engine Plugin<plugins>` to start your
CherryPy site as root (for example, to listen on a privileged port like 80)
and then reduce privileges to something more restricted.

This priority of this plugin's "start" listener is slightly higher than the
priority for ``server.start`` in order to facilitate the most common use:
starting on a low port (which requires root) and then dropping to another user.

Example::

    DropPrivileges(cherrypy.engine, uid=1000, gid=1000).subscribe()

.. currentmodule:: cherrypy.process.plugins

Classes
=======

.. autoclass:: DropPrivileges
   :members:
   :show-inheritance: