Provided by:
desktop-profiles_1.4.14_all 
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 increas‐
ingly unpleasant. This script remedies that allowing you to just list
your criteria, and outputting all profiles meeting those criteria.
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 expres‐
sion.
-k <regexp>, --kind <regexp>
Limit shown profiles to those for which the kind (2nd) field of
the profile description needs matches the given regular expres‐
sion.
-l <regexp>, --location <regexp>
Limit shown profiles to those for which the location (3th) field
of the profile description needs matches the given regular
expression.
-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 prece‐
dence)
-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
expression.
-u <username>, --user <username>
Limit shown profiles to those for which the given user meets the
requirements. (NOTE: might not work when using shell command
requirements that depend on the users environment).
-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, PRECE‐
DENCE, 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 - $DESCRIP‐
TION’). 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; field‐
numbers 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 com‐
parisons. 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 .list‐
ing 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 com‐
mand 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>.
desktop-profiles(7), update-profile-cache(1), profiles-manager(1)