Search
j0ke.net Open Build Service
>
Projects
>
J0KE.NET
:
infrastructure
>
xdg-utils
> xdg-su.diff
Sign Up
|
Log In
Username
Password
Cancel
Overview
Repositories
Revisions
Requests
Users
Advanced
Attributes
Meta
File xdg-su.diff of Package xdg-utils
--- scripts/Makefile.in +++ scripts/Makefile.in @@ -19,8 +19,8 @@ xdg-icon-resource \ xdg-open \ xdg-email \ - xdg-screensaver -# xdg-su + xdg-screensaver \ + xdg-su # xdg-copy \ # xdg-file-dialog # xdg-terminal --- scripts/desc/xdg-su.xml +++ scripts/desc/xdg-su.xml @@ -0,0 +1,166 @@ +<?xml version="1.0"?> +<?xml-stylesheet type="text/xsl" + href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ +]> +<refentry id="xdg-su"> + <refentryinfo> + <title>xdg-su Manual</title> + <copyright> + <year>2006</year> + </copyright> + <author> + <firstname>Kevin</firstname> + <surname>Krammer</surname> + </author> + <address><email>kevin.krammer@gmx.at</email></address> + <author> + <firstname>Jeremy</firstname> + <surname>White</surname> + </author> + <address><email>jwhite@codeweavers.com</email></address> + <releaseinfo>This is release 0.5 of the xdg-su Manual.</releaseinfo> + </refentryinfo> + + <refmeta> + <refentrytitle>xdg-su</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>xdg-su</refname> + <refpurpose>run a GUI program as root after prompting for the root password</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis> + <command>xdg-su</command> + <arg><option>-u <replaceable>user</replaceable></option></arg> + <arg choice="plain"><option>-c <replaceable>command</replaceable></option></arg> + </cmdsynopsis> + <cmdsynopsis> + <command>xdg-su</command> + <group choice="req"> + <arg choice="plain"><option>--help</option></arg> + <arg choice="plain"><option>--manual</option></arg> + <arg choice="plain"><option>--version</option></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id="description"> + <title>Description</title> + <para> + xdg-su provides a graphical dialog that prompts the user for a password + to run <replaceable>command</replaceable> as <replaceable>user</replaceable> + or as root if no user was specified. + </para> + <para> + xdg-su is for use inside a desktop session only. + </para> + <para> + xdg-su discards any stdout and stderr output from + <replaceable>command</replaceable>. + </para> + </refsect1> + <refsect1 id="options"> + <title>Options</title> + <variablelist> + <varlistentry> + <term><option>-u <replaceable>user</replaceable></option></term> + <listitem> + <simpara> + run <replaceable>command</replaceable> as + <replaceable>user</replaceable>. The default is to run as root. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--help</option></term> + <listitem> + <simpara> + Show command synopsis. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--manual</option></term> + <listitem> + <simpara> + Show this manualpage. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--version</option></term> + <listitem> + <simpara> + Show the xdg-utils version information. + </simpara> + </listitem> + </varlistentry> + + </variablelist> + </refsect1> + <refsect1 id="exitcodes"> + <title>Exit Codes</title> + <para> + An exit code of 0 indicates success while a non-zero exit code + indicates failure. The following failure codes can be returned: + </para> + <variablelist> + <varlistentry> + <term><option>1</option></term> + <listitem> + <simpara> + Error in command line syntax. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><option>2</option></term> + <listitem> + <simpara> + One of the files passed on the command line did not exist. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><option>3</option></term> + <listitem> + <simpara> + A required tool could not be found. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><option>4</option></term> + <listitem> + <simpara> + The action failed. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + <refsect1 id="seealso"> + <title>See Also</title> + <para><citerefentry><refentrytitle>su</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + </para> + </refsect1> + <refsect1 id="examples"> + <title>Examples</title> + <para> +<programlisting> +xdg-su -u root -c "/opt/shinythings/bin/install-GUI --install fast" +</programlisting> + Runs the /opt/shinythings/bin/install-GUI command with root permissions. + </para> + </refsect1> +</refentry> --- scripts/html/xdg-su.html +++ scripts/html/xdg-su.html @@ -0,0 +1,36 @@ +<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xdg-su</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="xdg-su"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>xdg-su — run a GUI program as root after prompting for the root password</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">xdg-su</code> [<code class="option">-u <em class="replaceable"><code>user</code></em></code>] <code class="option">-c <em class="replaceable"><code>command</code></em></code> </p></div><div class="cmdsynopsis"><p><code class="command">xdg-su</code> { <code class="option">--help</code> | <code class="option">--manual</code> | <code class="option">--version</code> }</p></div></div><div class="refsect1" lang="en"><a name="description"></a><h2>Description</h2><p> + xdg-su provides a graphical dialog that prompts the user for a password + to run <em class="replaceable"><code>command</code></em> as <em class="replaceable"><code>user</code></em> + or as root if no user was specified. + </p><p> + xdg-su is for use inside a desktop session only. + </p><p> + xdg-su discards any stdout and stderr output from + <em class="replaceable"><code>command</code></em>. + </p></div><div class="refsect1" lang="en"><a name="options"></a><h2>Options</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">-u <em class="replaceable"><code>user</code></em></code></span></dt><dd> + run <em class="replaceable"><code>command</code></em> as + <em class="replaceable"><code>user</code></em>. The default is to run as root. + </dd><dt><span class="term"><code class="option">--help</code></span></dt><dd> + Show command synopsis. + </dd><dt><span class="term"><code class="option">--manual</code></span></dt><dd> + Show this manualpage. + </dd><dt><span class="term"><code class="option">--version</code></span></dt><dd> + Show the xdg-utils version information. + </dd></dl></div></div><div class="refsect1" lang="en"><a name="exitcodes"></a><h2>Exit Codes</h2><p> + An exit code of 0 indicates success while a non-zero exit code + indicates failure. The following failure codes can be returned: + </p><div class="variablelist"><dl><dt><span class="term"><code class="option">1</code></span></dt><dd> + Error in command line syntax. + </dd><dt><span class="term"><code class="option">2</code></span></dt><dd> + One of the files passed on the command line did not exist. + </dd><dt><span class="term"><code class="option">3</code></span></dt><dd> + A required tool could not be found. + </dd><dt><span class="term"><code class="option">4</code></span></dt><dd> + The action failed. + </dd></dl></div></div><div class="refsect1" lang="en"><a name="seealso"></a><h2>See Also</h2><p><span class="citerefentry"><span class="refentrytitle">su</span>(1)</span> + </p></div><div class="refsect1" lang="en"><a name="examples"></a><h2>Examples</h2><p> +</p><pre class="programlisting"> +xdg-su -u root -c "/opt/shinythings/bin/install-GUI --install fast" +</pre><p> + Runs the /opt/shinythings/bin/install-GUI command with root permissions. + </p></div></div></body></html> --- scripts/man/xdg-su.1 +++ scripts/man/xdg-su.1 @@ -0,0 +1,75 @@ +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "XDG\-SU" "1" "07/31/2006" "This is release 0.5 of the xdg\-su Manual" "" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +xdg\-su \- run a GUI program as root after prompting for the root password +.SH "SYNOPSIS" +.HP 7 +\fBxdg\-su\fR [\fB\-u\ \fR\fB\fIuser\fR\fR] \fB\-c\ \fR\fB\fIcommand\fR\fR +.HP 7 +\fBxdg\-su\fR {\fB\-\-help\fR \fB\-\-manual\fR \fB\-\-version\fR} +.SH "DESCRIPTION" +.PP +xdg\-su provides a graphical dialog that prompts the user for a password to run +\fIcommand\fR +as +\fIuser\fR +or as root if no user was specified. +.PP +xdg\-su is for use inside a desktop session only. +.PP +xdg\-su discards any stdout and stderr output from +\fIcommand\fR. +.SH "OPTIONS" +.TP +\fB\-u \fR\fB\fIuser\fR\fR +run +\fIcommand\fR +as +\fIuser\fR. The default is to run as root. +.TP +\fB\-\-help\fR +Show command synopsis. +.TP +\fB\-\-manual\fR +Show this manualpage. +.TP +\fB\-\-version\fR +Show the xdg\-utils version information. +.SH "EXIT CODES" +.PP +An exit code of 0 indicates success while a non\-zero exit code indicates failure. The following failure codes can be returned: +.TP +\fB1\fR +Error in command line syntax. +.TP +\fB2\fR +One of the files passed on the command line did not exist. +.TP +\fB3\fR +A required tool could not be found. +.TP +\fB4\fR +The action failed. +.SH "SEE ALSO" +.PP +\fBsu\fR(1) +.SH "EXAMPLES" +.PP +.nf +xdg\-su \-u root \-c "/opt/shinythings/bin/install\-GUI \-\-install fast" +.fi +.sp +Runs the /opt/shinythings/bin/install\-GUI command with root permissions. +.SH "AUTHOR" +Kevin Krammer, Jeremy White. +.br +<kevin.krammer@gmx.at> +.br +<jwhite@codeweavers.com> --- scripts/xdg-su +++ scripts/xdg-su @@ -0,0 +1,434 @@ +#!/bin/sh +#--------------------------------------------- +# xdg-su +# +# Utility script to run a command as an alternate user, generally +# the root user, with a graphical prompt for the root +# password if needed +# +# Refer to the usage() function below for usage. +# +# Copyright 2006, Jeremy White <jwhite@codeweavers.com> +# Copyright 2006, Kevin Krammer <kevin.krammer@gmx.at> +# +# LICENSE: +# +# Permission is hereby granted, free of charge, to any person obtaining a +# copy of this software and associated documentation files (the "Software"), +# to deal in the Software without restriction, including without limitation +# the rights to use, copy, modify, merge, publish, distribute, sublicense, +# and/or sell copies of the Software, and to permit persons to whom the +# Software is furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included +# in all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR +# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +# OTHER DEALINGS IN THE SOFTWARE. +# +#--------------------------------------------- + +manualpage() +{ +cat << _MANUALPAGE +Name + +xdg-su - run a GUI program as root after prompting for the root password + +Synopsis + +xdg-su [-u user] -c command + +xdg-su { --help | --manual | --version } + +Description + +xdg-su provides a graphical dialog that prompts the user for a password to run +command as user or as root if no user was specified. + +xdg-su is for use inside a desktop session only. + +xdg-su discards any stdout and stderr output from command. + +Options + +-u user + run command as user. The default is to run as root. +--help + Show command synopsis. +--manual + Show this manualpage. +--version + Show the xdg-utils version information. + +Exit Codes + +An exit code of 0 indicates success while a non-zero exit code indicates +failure. The following failure codes can be returned: + +1 + Error in command line syntax. +2 + One of the files passed on the command line did not exist. +3 + A required tool could not be found. +4 + The action failed. + +See Also + +su(1) + +Examples + +xdg-su -u root -c "/opt/shinythings/bin/install-GUI --install fast" + +Runs the /opt/shinythings/bin/install-GUI command with root permissions. + +_MANUALPAGE +} + +usage() +{ +cat << _USAGE +xdg-su - run a GUI program as root after prompting for the root password + +Synopsis + +xdg-su [-u user] -c command + +xdg-su { --help | --manual | --version } + +_USAGE +} + +#@xdg-utils-common@ + +#---------------------------------------------------------------------------- +# Common utility functions included in all XDG wrapper scripts +#---------------------------------------------------------------------------- + +DEBUG() +{ + [ ${XDG_UTILS_DEBUG_LEVEL-0} -lt $1 ] && return 0; + shift + echo "$@" >&2 +} + +#------------------------------------------------------------- +# Exit script on successfully completing the desired operation + +exit_success() +{ + if [ $# -gt 0 ]; then + echo "$@" + echo + fi + + exit 0 +} + + +#----------------------------------------- +# Exit script on malformed arguments, not enough arguments +# or missing required option. +# prints usage information + +exit_failure_syntax() +{ + if [ $# -gt 0 ]; then + echo "xdg-su: $@" >&2 + echo "Try 'xdg-su --help' for more information." >&2 + else + usage + echo "Use 'man xdg-su' or 'xdg-su --manual' for additional info." + fi + + exit 1 +} + +#------------------------------------------------------------- +# Exit script on missing file specified on command line + +exit_failure_file_missing() +{ + if [ $# -gt 0 ]; then + echo "xdg-su: $@" >&2 + fi + + exit 2 +} + +#------------------------------------------------------------- +# Exit script on failure to locate necessary tool applications + +exit_failure_operation_impossible() +{ + if [ $# -gt 0 ]; then + echo "xdg-su: $@" >&2 + fi + + exit 3 +} + +#------------------------------------------------------------- +# Exit script on failure returned by a tool application + +exit_failure_operation_failed() +{ + if [ $# -gt 0 ]; then + echo "xdg-su: $@" >&2 + fi + + exit 4 +} + +#------------------------------------------------------------ +# Exit script on insufficient permission to read a specified file + +exit_failure_file_permission_read() +{ + if [ $# -gt 0 ]; then + echo "xdg-su: $@" >&2 + fi + + exit 5 +} + +#------------------------------------------------------------ +# Exit script on insufficient permission to read a specified file + +exit_failure_file_permission_write() +{ + if [ $# -gt 0 ]; then + echo "xdg-su: $@" >&2 + fi + + exit 6 +} + +check_input_file() +{ + if [ ! -e "$1" ]; then + exit_failure_file_missing "file '$1' does not exist" + fi + if [ ! -r "$1" ]; then + exit_failure_file_permission_read "no permission to read file '$1'" + fi +} + +check_vendor_prefix() +{ + file=`basename "$1"` + case "$file" in + [a-zA-Z]*-*) + return + ;; + esac + + echo "xdg-su: filename '$file' does not have a proper vendor prefix" >&2 + echo 'A vendor prefix consists of alpha characters ([a-zA-Z]) and is terminated' >&2 + echo 'with a dash ("-"). An example filename is '"'example-$file'" >&2 + echo "Use --novendor to override or 'xdg-su --manual' for additional info." >&2 + exit 1 +} + +check_output_file() +{ + # if the file exists, check if it is writeable + # if it does not exists, check if we are allowed to write on the directory + if [ -e "$1" ]; then + if [ ! -w "$1" ]; then + exit_failure_file_permission_write "no permission to write to file '$1'" + fi + else + DIR=`dirname "$1"` + if [ ! -w "$DIR" -o ! -x "$DIR" ]; then + exit_failure_file_permission_write "no permission to create file '$1'" + fi + fi +} + +#---------------------------------------- +# Checks for shared commands, e.g. --help + +check_common_commands() +{ + while [ $# -gt 0 ] ; do + parm="$1" + shift + + case "$parm" in + --help) + usage + echo "Use 'man xdg-su' or 'xdg-su --manual' for additional info." + exit_success + ;; + + --manual) + manualpage + exit_success + ;; + + --version) + echo "xdg-su 1.0beta2" + exit_success + ;; + esac + done +} + +check_common_commands "$@" +if [ ${XDG_UTILS_DEBUG_LEVEL-0} -lt 1 ]; then + # Be silent + xdg_redirect_output=" > /dev/null 2> /dev/null" +else + # All output to stderr + xdg_redirect_output=" >&2" +fi + +#-------------------------------------- +# Checks for known desktop environments +# set variable DE to the desktop environments name, lowercase + +detectDE() +{ + if [ x"$KDE_FULL_SESSION" = x"true" ]; then DE=kde; + elif [ x"$GNOME_DESKTOP_SESSION_ID" != x"" ]; then DE=gnome; + elif xprop -root _DT_SAVE_MODE | grep ' = \"xfce4\"$' >/dev/null 2>&1; then DE=xfce; + fi +} + +#---------------------------------------------------------------------------- + + + +su_kde() +{ + KDESU=`which kdesu 2>/dev/null` + if [ $? -eq 0 ] ; then + if [ -z "$user" ] ; then + $KDESU -c "$cmd" + else + $KDESU -u "$user" -c "$cmd" + fi + + if [ $? -eq 0 ]; then + exit_success + else + exit_failure_operation_failed + fi + else + su_generic + fi +} + +su_gnome() +{ + GSU=`which gnomesu 2>/dev/null` + if [ $? -ne 0 ] ; then + GSU=`which xsu 2>/dev/null` + fi + if [ $? -eq 0 ] ; then + if [ -z "$user" ] ; then + $GSU -c "$cmd" + else + $GSU -u "$user" -c "$cmd" + fi + + if [ $? -eq 0 ]; then + exit_success + else + exit_failure_operation_failed + fi + else + su_generic + fi +} + +su_generic() +{ + if [ -z "$user" ] ; then + xterm -geom 60x5 -T "xdg-su: $cmd" -e su -c "$cmd" + else + xterm -geom 60x5 -T "xdg-su: $cmd" -e su -u "$user" -c "$cmd" + fi + + if [ $? -eq 0 ]; then + exit_success + else + exit_failure_operation_failed + fi +} + +[ x"$1" != x"" ] || exit_failure_syntax + +user= +cmd= +while [ $# -gt 0 ] ; do + parm="$1" + shift + + case "$parm" in + -u) + if [ -z "$1" ] ; then + exit_failure_syntax "user argument missing for -u" + fi + user="$1" + shift + ;; + + -c) + if [ -z "$1" ] ; then + exit_failure_syntax "command argument missing for -c" + fi + cmd="$1" + shift + ;; + + -*) + exit_failure_syntax "unexpected option '$parm'" + ;; + + *) + exit_failure_syntax "unexpected argument '$parm'" + ;; + esac +done + +if [ -z "${cmd}" ] ; then + exit_failure_syntax "command missing" +fi + +detectDE + +if [ x"$DE" = x"" ]; then + which xterm 2>/dev/null >&2 + if [ $? -eq 0 -a -n "$DISPLAY" ] ; then + DE=generic + fi +fi + +case "$DE" in + kde) + su_kde + ;; + + gnome) + su_gnome + ;; + + generic) + su_generic + ;; + + *) + [ x"$user" = x"" ] && user=root + exit_failure_operation_impossible "no graphical method available for invoking '$cmd' as '$user'" + ;; +esac
