%general-entities; ]> $Date$ Polkit-&polkit-version; Polkit Introduction to Polkit Polkit is a toolkit for defining and handling authorizations. It is used for allowing unprivileged processes to communicate with privileged processes. &lfs110a_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &polkit-md5sum; Download size: &polkit-size; Estimated disk space required: &polkit-buildsize; Estimated build time: &polkit-time; Polkit Dependencies Required and Recommended , , and Since elogind systemd-logind uses PAM to register user sessions, it is a good idea to build Polkit with PAM support so elogind systemd-logind can track Polkit sessions. Optional and (for tests), and Required Runtime Dependencies Optional Runtime Dependencies One polkit authentication agent for using polkit in the graphical environment: polkit-kde-agent in for KDE, the agent built in for GNOME3, for XFCE, and lxpolkit in for LXDE. If is installed, then and are required. If you have installed , but you do not want to install any of the DocBook packages mentioned, you will need to use in the instructions below. User Notes: Installation of Polkit There should be a dedicated user and group to take control of the polkitd daemon after it is started. Issue the following commands as the root user: groupadd -fg 27 polkitd && useradd -c "PolicyKit Daemon Owner" -d /etc/polkit-1 -u 27 \ -g polkitd -s /bin/false polkitd First, fix problems with setting permissions during installation and with meson-0.60.0: sed '/0,/s/^/#/' -i meson_post_install.py && sed '/policy,/d' -i actions/meson.build \ -i src/examples/meson.build Install Polkit by running the following commands: mkdir build && cd build && meson --prefix=/usr \ -Dman=true \ -Dsession_tracking=libsystemd-login \ --buildtype=release \ .. && ninja mkdir build && cd build && meson --prefix=/usr \ -Dman=true \ -Dsession_tracking=libelogind \ -Dsystemdsystemunitdir=/tmp \ --buildtype=release \ .. && ninja This package does not ship with a working test suite. Now, as the root user: ninja install ninja install && rm -v /tmp/*.service Command Explanations : This switch enables the package to use the Shadow rather than the Linux PAM Authentication framework. Use it if you have not installed Linux PAM. : Use this option if you are certain that you do not need gobject-introspection files for polkit, or do not have gobject-introspection installed. : Use this option to disable generating and installing manual pages. This is useful if libxslt is not installed. : Use this option to build the example programs. : Use this option to enable building and installing the API documentation. Configuring Polkit PAM Configuration If you did not build Polkit with Linux PAM support, you can skip this section. If you have built Polkit with Linux PAM support, you need to modify the default PAM configuration file which was installed by default to get Polkit to work correctly with BLFS. Issue the following commands as the root user to create the configuration file for Linux PAM: cat > /etc/pam.d/polkit-1 << "EOF" # Begin /etc/pam.d/polkit-1 auth include system-auth account include system-account password include system-password session include system-session # End /etc/pam.d/polkit-1 EOF Contents Installed Programs Installed Libraries Installed Directories pkaction, pkcheck, pkexec, pkttyagent and polkitd libpolkit-agent-1.so and libpolkit-gobject-1.so /etc/polkit-1, /usr/include/polkit-1, /usr/lib/polkit-1, /usr/share/gtk-doc/html/polkit-1 and /usr/share/polkit-1 Short Descriptions pkaction is used to obtain information about registered PolicyKit actions pkaction pkcheck is used to check whether a process is authorized for action pkcheck pkexec allows an authorized user to execute a command as another user pkexec pkttyagent is used to start a textual authentication agent for the subject pkttyagent polkitd provides the org.freedesktop.PolicyKit1 D-Bus service on the system message bus polkitd libpolkit-agent-1.so contains the Polkit authentication agent API functions libpolkit-agent-1.so libpolkit-gobject-1.so contains the Polkit authorization API functions libpolkit-gobject-1.so