Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   20441 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

canberra-gtk-play(1)		 User Commands		  canberra-gtk-play(1)

NAME
       canberra-gtk-play - play a sound event

SYNOPSIS
       canberra-gtk-play	    [--cache-control=permanent|volatile|never]
       [--description=description] [--display=display] [--file=file]  [--help]
       [--id=identifier] [--loop=times] [--version] [gnome-std-options]

DESCRIPTION
       canberra-gtk-play  is  an application for playing sound events that are
       specified by the FreeDesktop "XDG Sound Theme and Name Specification".

OPTIONS
       The following options are supported:

       --c, --cache-control=[permanent|volatile|never]

	   Specify how canberra-gtk-play will manage its cache	control.   The
	   value  of  "permanent"  will	 cause	the sample to be cached in the
	   server permanently.	 This  is  useful  for	very  frequently  used
	   sounds.   The value of "volatile" may be used for caching sounds in
	   the sound server temporarily.  They will expire after some time  or
	   on  cache  pressure.	  The value of "never" may be used that should
	   never be cached, because they are only generated very  seldomly  or
	   only once.

	   Not	all  libcanberra  backends support caching, and this option is
	   only functional if the backend being used does support  this	 func‐
	   tionality.

       -d, --description=description

	   Specify a description for the sound event.

       --display=display

	   Specify the X display to use.

       -f, --file=file

	   Specify a file to play.

       -?, --help

	   Display usage information.

       -i, --id=identifier

	   Specify  the event identifier to play.  These identifier values are
	   specified in the "XDG Sound Theme and Name Specification".

       -l, --loop=times

	   Specify the number of times to play the file.  The default value is
	   1.

       -v, --version

	   Display canberra-gtk-play version number.

       gnome-std-options

	   Standard  options  available	 for use with most GNOME applications.
	   See gnome-std-options(5lnum>) for more information.

EXAMPLES
       Example 1: Play the "desktop-login" sound event

       example% canberra-gtk-play --id desktop-login --description="GNOME Login"

FILES
       The following files are used by this application:

       /usr/bin/canberra-gtk-plExecutable to play an sound events

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

       ┌─────────────────────────────┬────────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	      ATTRIBUTE VALUE	      │
       ├─────────────────────────────┼────────────────────────────────┤
       │Availability		     │library/desktop/xdg/libcanberra │
       ├─────────────────────────────┼────────────────────────────────┤
       │Interface stability	     │Volatile			      │
       └─────────────────────────────┴────────────────────────────────┘

SEE ALSO
       libcanberra(3), attributes(5), gnome-std-options(5)

NOTES
       Written by Brian Cameron, Sun Microsystems Inc., 2009.

SunOS 5.11			  20 Feb 2009		  canberra-gtk-play(1)

Vote for polarhome