SYNOPSIS
xphone [ -hvs --bellcommand <unix command> --idlecommand <unix command &> --ringcommand <unix command &> --geometry <position> --iforeground <color> --ibackground <color> --rforeground <color> --rbackground <color> --idleimage <X11 bitmap file> --ringimage <X11 bitmap file> --version ]DESCRIPTION
xphone is a simple program which creates a window on an X display which contains a phone icon. If the system uses the GNU talk daemon, then this phone icon will ring whenever someone attempts to make a talk connection to you. When this happens, the phone icon will change, and the terminal will beep.Command line switches are:
- --bellcommand <unix command line>
- This option provides a hook into how one wishes a "bell" to be sounded. Setting this command to something like "play ring.au" will play a recorded sound instead of calling xbell. Any command which can be run from the system(3) call can be used.
- --idlecommand <unix command>
- Provide an alternate unix command to execute when clickon on the idle xphone icon. The default is "gtalk &". Be sure to append an & to the command being executed. Any command which can be run from the system(3) call can be used.
- --ringcommand <unix command>
- Provide an alternate unix command to execute when clickon on the idle xphone icon. The default is "gtalk -r &". Be sure to append an & to the command being executed. Any command which can be run from the system(3) call can be used.
- --geometry
- Change the default location of the window when it first starts up. Only the position is used, size is determined by the icon used.
- -h, --help
- Print process help.
- --ifg --iforeground <color>
- The foreground color to use on the idle phone icon.
- --ibg --ibackground <color>
- The background color to use on the idle phone icon.
- --idleimage <X11 bitmap file>
- A file which contains an X11 bitmap file created by the bitmap(1) command which represents an idle phone status.
- --rfg --rforeground <color>
- The foreground color to use on the ringing phone icon.
- --rbg --rbackground <color>
- The background color to use on the ringing phone icon.
- --ringimage <X11 bitmap file>
- A file which contains an X11 bitmap file created by the bitmap(1) command which indicates a ringing phone status.
- -s --silent
- Do not print out ring information to stdout.
- -v, --verbose
- Print out verbose information, or verbose syslog information.
- --version
- Print out the current version of xphone.
X RESOURCES
- xphone.geometry
- Default position at start up.
- xphone.title
- Name of the window in the window managers title bar
- xphone.iconname
- Name placed under the icon
- xphone.ringcommand
- Alternate command used to make a ringing sound
- xphone.idle.clickcommand
- Alternate program to run when clicking on xphone when no calls are pending. Default is "gtalk".
- xphone.ring.clickcommand
- Alternate program to run when clicking on xphone when calls are pending. Default is "gtalk -r".
- xphone.idle.foreground
- Foreground color of idle phone
- xphone.idle.background
- Background color of idle phone
- xphone.ring.foreground
- Foreground color of ringing phone
- xphone.ring.background
- Background color of ringing phone
- xphone.idle.bitmap
- Alternate bitmap for idle phone
- xphone.ring.bitmap
- Alternate bitmap for ringing phone @end table
FILES AND ENVIRONMENT
- ~/.ringer
- This is the "ringer" file which gtalkd reads. it holds a definition of a UDP socket address in host byte order. Gtalkd then sends the announcement to this socket instead of to the terminal associated with the user. If the definition in this file describes a host other than the one the talk daemon is on (a common occurrence in a network which uses NFS heavily), then a LOOK_HERE message is returned.
- $DISPLAY
- This variable describes an X display xphone will attempt to use when initializing the X interface.