Provided by: desktop-profiles_1.4.15ubuntu1_all bug

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)