PATH2LISTING(1) General Commands Manual PATH2LISTING(1)NAME
path2listing - script facilitating the conversion to managing gconf configuration sources with desktop-profiles
SYNOPSIS
path2listing [options]
DESCRIPTION
This script takes a single gconf path file (the systemwide one, i.e. /etc/gconf/2/path, when not told otherwise) and reads through it in
order to create an ordered list of known configuration sources (it will recurse into included path files when necessary). Using that
ordered list it will then create a desktop-profiles_path2listing.listing file containing metadata for all known configuration sources,
assigning a precedence value to each encountered configuration source so that:
a) the order of sources is the same
b) there is space between the precedence values of the various sources to allow for inclusion of additional profiles in the future.
c) all mandatory sources have a positive precedence value, and all non-mandatory sources have a negative precedence value
In addition to generating the desktop-profiles_path2listing.listing file, this script will also replace the converted path file by one that
assumes that desktop-profiles manages all configuration sources (NOTE: a backup copy of all changed files is made, so you can always go
back to the previous situation).
OPTIONS -d,--distance
distance between the precedence values of each successive pair of configuration sources (defaults to 50), the idea being that you
leave some space to insert future sources.
-f, --file
path file to convert (defaults to /etc/gconf/2/path)
-h, --help
display the help message
-o, --output-file
file to put the generated metadata in (defaults to /etc/desktop-profiles/desktop-profiles_path2listing.listing). If this file exists
a backup copy will be made prior to overwriting it.
--no-replace-file
don't replace the path file we're converted with one assuming desktop-profiles manages activation
FILES
/etc/gconf/2/path - systemwide gconf path file, default path file to convert
/etc/desktop-profiles/desktop-profiles_path2listing.listing - default name for the file containing the generated metadata
AUTHOR
This manual page was written by Bart Cornelis <cobaco@skolelinux.no>.
SEE ALSO desktop-profiles(7)desktop-profiles May 07, 2005 PATH2LISTING(1)
Check Out this Related Man Page
LIST-DESKTOP-PROFILES(1) General Commands Manual LIST-DESKTOP-PROFILES(1)NAME
list-desktop-profiles - list known profiles that meet given criteria
SYNOPSIS
list-desktop-profiles [OPTION]
DESCRIPTION
As the number of .listing files holding metadata grows, trying to find out which profiles are present/meet certain criteria becomes
increasingly unpleasant. This script remedies that allowing you to just list your criteria, and outputting all profiles meeting those cri-
teria.
By default it will just output the lines from the .listing files for each (matching) profile, but you can specifying a formatstring to
fancy up the output.
OPTIONS -n <regexp>, --name <regexp>
Limit shown profiles to those for which the name (1st) field of the profile description needs matches the given regular expression.
-k <regexp>, --kind <regexp>
Limit shown profiles to those for which the kind (2nd) field of the profile description needs matches the given regular expression.
-l <regexp>, --location <regexp>
Limit shown profiles to those for which the location (3th) field of the profile description needs matches the given regular expres-
sion.
-p <comparison>, --precedence <comparison>
Limit shown profiles to those for which the precedence (4th) field of the profile description succeeds the given comparison. In the
comparison you can Use 'gt' for 'greater then', 'lt' for 'less then', 'ge' for 'greater then or equal to', 'le' for 'less then or
equal to', 'eq' for 'equal to', and 'ne' for 'not equal to'. (NOTE: empty precedence-field, is lowest possible precedence)
-r <regexp>, --requirement <regexp>
Limit shown profiles to those for which the requirements (5th) field of the profile description needs matches the given regular
expression.
-c <regexp>, --comment <regexp>, --description <regexp>
Limit shown profiles to those for which the comment (6th) field of the profile description needs matches the given regular expres-
sion.
-u <username>, --user <username>
Limit shown profiles to those for which the given user meets the requirements. (NOTE: doesn't always give correct results! Results
might be wrong when using shell command requirements that depend on the users environment. Or when 'group $USER' gives a different
result as 'group' executed as $USER, which can happen when adding groups through pam_group).
-d <dir>, --directory <dir>
Also use .listing files found in the given directory. This option can be used multiple times to add more then 1 additional directory
-e <formatstring>, --entry-format <formatstring>
Show profile information according to the specified format spring (instead of just echoing the profile-line). The format string may
use the following variables: NAME, LOCATION, PRECEDENCE, REQUIREMENTS, KIND, DESCRIPTION, FILE; the first 6 of these refer to the
corresponding field, the last refers to the .listing file the profile is in. (e.g. '$FILE_$NAME - $DESCRIPTION'). Any characters
that are interpreted specially by the shell should be escaped.
-s <fieldname>|<fieldnumber>, --sort-key <fieldname>|fieldnumber
Sort output on the requested field (fieldname is one of name, kind, location, precedence, requirements, or description; fieldnumbers
run from 1-6).
EXAMPLES
list-desktop-profiles -k KDE -s precedence -u user1
List all kde-profiles that will be activated for user1 in order of precedence.
list-desktop-profiles -k 'KDE|GCONF'
List all kde and gnome profiles.
list-desktop-profiles -p 'gt 50'
List all profiles with a precedence value greater then 50.
ENVIRONMENT
NAME_FILTER, LOCATION_FILTER, PRECEDENCE_FILTER, REQUIREMENT_FILTER, KIND_FILTER, DESCRIPTION_FILTER
Can be used to specify the default regular expressions and comparisons. Default to empty.
OUR_USER
Set the user for which the requirements need to be met. Defaults to unset.
EXTRA_LISTINGS
Can be used to specify a (space separated) list of extra .listing files to include. Defaults to empty
FORMAT
Can be used to specify the default format string. By default it will output the profile-line from the .listing file.
SORT_KEY
Can be used to specify the default sort-key (= field number). Defaults to 1
FILES
/etc/desktop-profiles/*.listing - Files containing the metadata about installed profiles
/etc/default/desktop-profiles - File containing default settings for this script (by way of the environment variables above)
BUGS
The '-u <username>' is not guaranteed to work correctly for shell command requirements. Particulary this will give incorrect results if the
shell command depends on some state of the user environment.
AUTHOR
This manual page was written by Bart Cornelis <cobaco@skolelinux.no>.
SEE ALSO desktop-profiles(7), update-profile-cache(1), profiles-manager(1)desktop-profiles November 11, 2004 LIST-DESKTOP-PROFILES(1)