ohphone.man

openh323_1.1.2.2.zip； 2. 把pwlib_1.52.zip 、openh323_1.1.2.2.zip分别展开到目录e:h323sourcepwlib及e:h323sourc

ohphone(1)							    ohphone(1)



NAME
       ohphone - initiate, or receive, a H.323 IP telephony call

SYNOPSIS
       ohphone -l|--listen [options]...

       ohphone [options]... address

DESCRIPTION
       ohphone	is  a  command line application that can be used to listen for
       incoming H.323 calls, or to initiate a call to a remote host.  Although
       originally  intended  as	 a test harneess for the OpenH323 project (see
       http://www.openh323.org) it has developed into a fully functional H.323
       endpoint	 application.	ohphone	 includes  a  simple  menu that allows
       interactive control of functions, as well as allowing control  of  most
       dialling	 and  answer  functions	 via  a phone handset when used with a
       Quicknet (see http://www.quicknet.com) LineJack or PhoneJack.

       When used with the -l option, ohphone will wait for incoming calls.  If
       this  option  is not specified, ohphone expects a hostname to be speci-
       fied and will attempt to connect to a H.323 client at that address.


OPTIONS
       All of the command line options to ohphone can  be  specified  in  long
       form,  and  the	most  commonly used options also have single character
       equivalents. The long forms can also be used in the ohphone  configura-
       tion  file.  To disable or turn off a feature, use the long form of the
       name with the prefix --no-, i.e. --no-answer or --no-gsm.


       -a, --auto-answer
	      Automatically answer incoming calls.


       --aec level
	      Set the AEC (audio echo cancellation) level when using a	Quick-
	      net  card.   level must be in the range 0 through 3. The default
	      value is 2.


       --autohook
	      Automatically handle hook state for phone	 devices  that	appear
	      permanently  off-hook.  This option is intended for use with the
	      Quicknet PhoneCARD.


       --answer-timeout time
	      Time in seconds till forward on no answer.


       -b, --bandwidth bps
	      Limit bandwidth usage reported to gatekeeper to bps bits/second.


       -c, --callerid
	      Enable caller id display.


       --calleridcw
	      Enable caller id on call waiting display.


       --connectport port
	      Port to connect to for outgoing connections (default 1720).


       --connectring num
	      Distinctive ring number to send to remote: 0 (default) to 7.


       -C --country name
	      Set the country code for Quicknet device.


       -D, --disable codec
	      Disable the specified codec (may be used multiple times).


       -d, --autodial host
	      Automatically dial host if phone goes off hook.


       --dial-after-hangup
	      By default ohphone will present a busy tone when a connection is
	      broken, requiring the handset to be put on  hook	before	making
	      another call.  If this flag is specified, a new dialtone will be
	      presented, allowing a new connection to be made without  requir-
	      ing an hook transition.


       --disable-menu
	      Disable the internal menu.


       -e, --silence
	      Disable  silence	detection  and	removal	 for  GSM and software
	      G.711.


       -F, --forward-always party
	      Forward all calls to the remote specified party.


       -B, --forward-busy party
	      Forward to the remote specified party if busy.


       -N, --forward-no-answer party
	      Forward to the remote specified party on no answer. Timeout  for
	      no answer set with --answer-timeout.


       -f, --fast-disable
	      Do not request H323V2 FastConnect when initiaiting a connection.


       -h, --help
	      Show help message.


       -T, --h245tunnel-disable
	      Do not perform H245 tunneling when initiating a connection.


       -g, --gatekeeper host
	      Upon startup, register only with the specified gatekeeper rather
	      than attempting to find a gatekeeper by using UDP broadcast.


       -G, --gatekeeper-id name
	      Specify gatekeeper by ID.


       --g711-ulaw
	      Set G.711 uLaw as preferred codec.


       --g711-Alaw
	      Set G.711 ALaw as preferred codec.


       --g711frames count
	      Set the number G.711 frames in capabilities (default 30).


       --g7231
	      Set G.723.1 as preferred codec, when using a Quicknet card.


       --g728 Set G.728 as preferred codec.


       --gsm  Use GSM 06.10 as preferred codec.


       --gsmframes count
	      Set the number GSM frames in capabilities (default 4).


       --h261 device
	      This  option  has	 been deprecated in favour of the videoreceive
	      and videotransmit options


       -i, --interface interface
	      Only bind	 to  the  specified  network  interface	 address.   By
	      default, ohphone automatically listens for incoming calls on all
	      TCP/IP network interfaces available on the host  machine.	  This
	      option  is  useful for running multiple copies of ohphone on the
	      same multi-homed machine, or for ensuring that only  calls  from
	      the external, or internal, network will be received on a partic-
	      ular handset.


       -j, --jitter delay
	      Set jitter buffer to delay ms. By default, the jitter buffer  is
	      set to 50 ms.


       -l, --listen
	      Listen for incoming calls.


       --listenport port
	      Listen on the specified tcp port instead of the default 1720.


       -n, --no-gatekeeper
	      Do  not  attempt	to  find  a  gatekeeper upon startup using UDP
	      broadcast.


       -o, --output filename
	      Write trace output (enabled with the -t option) to the specified
	      file rather than to stderr.


       -P, --prefer codec
	      Sets the prefered codec to the specified codec. If used multiple
	      times, it specifies an order in preference, being the first  one
	      specified the most prefered one.


       -p, --proxy host
	      Connect  to  the remote endpoint using the specified H.323 proxy
	      host, rather than attempting to connect directly.


       --playvol vol
	      Set the playback volume. For sound cards,	 this  is  an  integer
	      value  from  0  through  100. For Quicknet cards, this is a real
	      number from 0.0 through 16.0 (1.0 is normal volume)


       -q, --quicknet num
	      Use the specified Linux telephony device (/dev/phonenum)	rather
	      than a sound card. This overrides the default of using the sound
	      card.


       --quicknet-playvol vol
	      Set the playback volume when a Quicknet card is used. This over-
	      rides the value of --playvol (if set). The volume is a real num-
	      ber from 0.0 through 16.0 (1.0 is normal volume).


       --quicknet-recvol vol
	      Set the record volume when a Quicknet card is used.  This	 over-
	      rides  the value of --recvol (if set). The volume is a real num-
	      ber from 0.0 through 16.0 (1.0 is normal volume).


       -r, --require-gatekeeper
	      Exit if a gatekeeper cannot be found.


       --recvol vol
	      Set the record volume. For sound cards, this is an integer value
	      from  0  through	100. For Quicknet cards, this is a real number
	      from 0.0 through 16.0 (1.0 is normal volume)


       --ringfile filename
	      Play the PCM data in filename when an incoming call arrives.


       --ringdelay delay
	      If the --ringfile option is specified, this option  defines  how
	      many  to delay between playing each ring. If the delay is speci-
	      fied as -1, then the file is only played once. If	 it  is	 zero,
	      then  the	 file  loops  continuously  with no delay. The default
	      delay is 5 seconds.


       --save Save arguments in configuration file.


       --setup-param string
	      Arbitrary data to be put into H.225 Setup PDU.


       -s, --sound device
	      Select the sound input and output device. The default  value  is
	      /dev/dsp0.


       --sound-buffers n
	      Set sound buffer depth (default=2)


       --sound-mixer device
	      Select  the  sound  card	mixer  device.	The  default  value is
	      /dev/mixer0


       --sound-recchan device
	      Select the sound card record channel. By default, the mic	 chan-
	      nel is used.


       --sound-in, --sound-out device
	      Select  the sound input or output device seperately. Only needed
	      if different sound devices are needed for input and output.


       --sound-playvol vol
	      Set the playback volume when a sound card is  used.  This	 over-
	      rides  the value of --playvol (if set). The volume is an integer
	      value from 0 through 100


       --sound-recvol vol
	      Set the record volume when a sound card is used. This  overrides