xdg-user-dir(1) 						   User Commands						   xdg-user-dir(1)

NAME

       xdg-user-dir - Get the path used for desktop user directory location.

SYNOPSIS

       xdg-user-dir DIR

DESCRIPTION

       xdg-user-dir is a utility that extracts the location of the specified desktop user directory from the file :

	   ${HOME}/.config/user-dirs.dirs

OPERANDS

       Valid desktop directories (DIR) are:

	       DESKTOP
	       DOWNLOAD
	       TEMPLATES
	       PUBLICSHARE
	       DOCUMENTS
	       MUSIC
	       PICTURES
	       VIDEOS

       If an invalid directory is requested ${HOME} is returned.

ENVIRONMENT VARIABLES

       See environ(5) for descriptions of the following environment variables:

	   HOME.

       Other environment variable that are used are:

       XDG_CONFIG_HOME

	   Base directory for storge of XDG configuration files. Defaults to ${HOME}/.config

FILES

       The following files are used by this application:

       /usr/bin/xdg-user-dir

	   XDG Directory expansion utility.

       ${XDG_CONFIG_HOME}/user-dirs.dirs

	   Location of the user-specific configuration including the current list of directories and what they map to.

EXAMPLES

       Example 1: Location of user's documents directory

       % xdg-user-dir DOCUMENTS

       /home/user/Documents

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWxdg-user-dirs 	   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       More information can be found at:

       http://www.freedesktop.org/wiki/Software/xdg-user-dirs

       xdg-user-dirs-update(1), xdg-user-dirs-gtk-update(1), attributes(5)

NOTES

       Written by Darren Kenny, Sun Microsystems Inc, 2008

SunOS 5.11							    03 Apr 2008 						   xdg-user-dir(1)