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)