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)

desktop-profiles                                November 11, 2004                       LIST-DESKTOP-PROFILES(1)