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
       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 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 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 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 expression.

       -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)