diff options
| author | Anas Nashif <anas.nashif@intel.com> | 2013-03-07 08:09:14 -0800 |
|---|---|---|
| committer | Anas Nashif <anas.nashif@intel.com> | 2013-03-07 08:09:14 -0800 |
| commit | 16119b2b96e935743238c6ebbc39dc74c1aa6cf6 (patch) | |
| tree | 98e78fd52a4f6f131e2c4e34e59e6448ed1faef4 | |
| parent | 7680502dee971654fd425d2c35e843232d91530a (diff) | |
| download | dbus-glib-16119b2b96e935743238c6ebbc39dc74c1aa6cf6.tar.gz dbus-glib-16119b2b96e935743238c6ebbc39dc74c1aa6cf6.tar.bz2 dbus-glib-16119b2b96e935743238c6ebbc39dc74c1aa6cf6.zip | |
Imported Upstream version 0.100.2upstream/0.100.2upstream
62 files changed, 4768 insertions, 4040 deletions
@@ -1,3 +1,127 @@ +commit 02b44f8427ea48463d7b9f2a9f7099be7643b60d +Author: Simon McVittie <simon.mcvittie@collabora.co.uk> +Date: 2013-02-25 12:24:35 +0000 + + 0.102: respin tarball + + configure.ac | 2 +- + 1 file changed, 1 insertion(+), 1 deletion(-) + +commit 78f3e953e4a05a1126874dd2ca6cec5777a15b3b +Author: Simon McVittie <simon.mcvittie@collabora.co.uk> +Date: 2013-02-15 12:37:04 +0000 + + 0.100.1 point release + + configure.ac | 2 +- + 1 file changed, 1 insertion(+), 1 deletion(-) + +commit 166978a09cf5edff4028e670b6074215a4c75eca +Author: Colin Walters <walters@verbum.org> +Date: 2013-02-14 10:19:34 -0500 + + CVE-2013-0292: dbus-gproxy: Verify sender of NameOwnerChanged signals + to be o.f.DBus + + Anyone can hop on the bus and emit a signal whose interface is + o.f.DBus; it's expected at the moments that clients (and notably DBus + libraries) check the sender. + + This could previously be used to trick a system service using + dbus-glib + into thinking a malicious signal came from a privileged source, by + claiming that ownership of the privileged source's well-known name had + changed from the privileged source's real unique name to the + attacker's + unique name. + + [altered to be NULL-safe so it won't crash on peer connections -smcv] + Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> + Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk> + + dbus/dbus-gproxy.c | 7 ++++--- + 1 file changed, 4 insertions(+), 3 deletions(-) + +commit c6cbdf9ed99f82983dd529319475dd02c53ad2aa +Author: Simon McVittie <simon.mcvittie@collabora.co.uk> +Date: 2012-06-25 18:23:30 +0100 + + Fix builds without tests + + test/manual/Makefile.am | 5 +++++ + 1 file changed, 5 insertions(+) + +commit a0dd0c8c240896a5dd205c1dbc51924b9d41f833 +Author: Simon McVittie <simon.mcvittie@collabora.co.uk> +Date: 2012-06-25 17:26:48 +0100 + + Prepare version 0.100 + + configure.ac | 4 ++-- + 1 file changed, 2 insertions(+), 2 deletions(-) + +commit 8b7e4a1c4ae055864e26db4addbcc2dc38ee6963 +Author: Simon McVittie <simon.mcvittie@collabora.co.uk> +Date: 2012-04-16 12:11:38 +0100 + + Fix two crashes when dbus_g_proxy_new_for_peer is used on a bus + + The first part of the bug is that when NameOwnerChanged is received + with + a dbus_g_proxy_new_for_peer (which has no name) alive, checking + whether it was affected by the NameOwnerChanged caused a NULL + dereference and segfault. + + The second part of the bug is that if the last proxy in existence is + for a peer, when it was unregistered there would be no + owner_match_rules, + causing a crash. + + Both are exercised in the new test added here. + + Bug: https://bugs.freedesktop.org/show_bug.cgi?id=41126 + Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> + Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> + + .gitignore | 1 + + dbus/dbus-gproxy.c | 5 +- + test/core/Makefile.am | 3 + + test/core/peer-on-bus.c | 148 + +++++++++++++++++++++++++++++++++++++++++++++++ + test/core/run-test.sh | 1 + + 5 files changed, 156 insertions(+), 2 deletions(-) + +commit 82d45d15088d206f1e1f024215e95301fa04e92c +Author: Simon McVittie <simon.mcvittie@collabora.co.uk> +Date: 2012-04-16 12:10:37 +0100 + + Add a utility function to tear down a private connection in tests + + Bug: https://bugs.freedesktop.org/show_bug.cgi?id=41126 + Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> + + configure.ac | 1 + + test/Makefile.am | 4 +-- + test/core/Makefile.am | 4 ++- + test/interfaces/Makefile.am | 4 ++- + test/lib/Makefile.am | 19 ++++++++++++ + test/lib/util.c | 69 + +++++++++++++++++++++++++++++++++++++++++++ + test/lib/util.h | 32 ++++++++++++++++++++ + 7 files changed, 129 insertions(+), 4 deletions(-) + +commit 403c5bf4d98fcba83caa94aee96da27128bbf9c8 +Author: Matthias Klose <doko@ubuntu.com> +Date: 2012-06-25 17:11:45 +0100 + + Fix build error with -Werror=format-security + + Origin: vendor, Ubuntu + Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk> + + dbus/dbus-gobject.c | 2 +- + 1 file changed, 1 insertion(+), 1 deletion(-) + commit ae0ed3e435c550c3fae1a86a1c3cb42da319dff2 Author: Simon McVittie <simon.mcvittie@collabora.co.uk> Date: 2011-09-28 17:42:44 +0100 diff --git a/Makefile.in b/Makefile.in index e71f748..e1f7539 100644 --- a/Makefile.in +++ b/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, @@ -718,7 +718,7 @@ distcheck: dist *.zip*) \ unzip $(distdir).zip ;;\ esac - chmod -R a-w $(distdir); chmod a+w $(distdir) + chmod -R a-w $(distdir); chmod u+w $(distdir) mkdir $(distdir)/_build mkdir $(distdir)/_inst chmod a-w $(distdir) @@ -1,4 +1,4 @@ -# generated automatically by aclocal 1.11.5 -*- Autoconf -*- +# generated automatically by aclocal 1.11.6 -*- Autoconf -*- # Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, # 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, @@ -198,7 +198,7 @@ AC_DEFUN([AM_AUTOMAKE_VERSION], [am__api_version='1.11' dnl Some users find AM_AUTOMAKE_VERSION and mistake it for a way to dnl require some minimum version. Point them to the right macro. -m4_if([$1], [1.11.5], [], +m4_if([$1], [1.11.6], [], [AC_FATAL([Do not call $0, use AM_INIT_AUTOMAKE([$1]).])])dnl ]) @@ -214,7 +214,7 @@ m4_define([_AM_AUTOCONF_VERSION], []) # Call AM_AUTOMAKE_VERSION and AM_AUTOMAKE_VERSION so they can be traced. # This function is AC_REQUIREd by AM_INIT_AUTOMAKE. AC_DEFUN([AM_SET_CURRENT_AUTOMAKE_VERSION], -[AM_AUTOMAKE_VERSION([1.11.5])dnl +[AM_AUTOMAKE_VERSION([1.11.6])dnl m4_ifndef([AC_AUTOCONF_VERSION], [m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl _AM_AUTOCONF_VERSION(m4_defn([AC_AUTOCONF_VERSION]))]) diff --git a/config.guess b/config.guess index 40eaed4..d622a44 100755 --- a/config.guess +++ b/config.guess @@ -2,9 +2,9 @@ # Attempt to guess a canonical system name. # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, # 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, -# 2011 Free Software Foundation, Inc. +# 2011, 2012 Free Software Foundation, Inc. -timestamp='2011-05-11' +timestamp='2012-02-10' # This file is free software; you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by @@ -17,9 +17,7 @@ timestamp='2011-05-11' # General Public License for more details. # # You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA -# 02110-1301, USA. +# along with this program; if not, see <http://www.gnu.org/licenses/>. # # As a special exception to the GNU General Public License, if you # distribute this file as part of a program that contains a @@ -57,8 +55,8 @@ GNU config.guess ($timestamp) Originally written by Per Bothner. Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free -Software Foundation, Inc. +2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 +Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." @@ -145,7 +143,7 @@ UNAME_VERSION=`(uname -v) 2>/dev/null` || UNAME_VERSION=unknown case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in *:NetBSD:*:*) # NetBSD (nbsd) targets should (where applicable) match one or - # more of the tupples: *-*-netbsdelf*, *-*-netbsdaout*, + # more of the tuples: *-*-netbsdelf*, *-*-netbsdaout*, # *-*-netbsdecoff* and *-*-netbsd*. For targets that recently # switched to ELF, *-*-netbsd* would select the old # object file format. This provides both forward @@ -792,13 +790,12 @@ EOF echo ${UNAME_MACHINE}-unknown-bsdi${UNAME_RELEASE} exit ;; *:FreeBSD:*:*) - case ${UNAME_MACHINE} in - pc98) - echo i386-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; + UNAME_PROCESSOR=`/usr/bin/uname -p` + case ${UNAME_PROCESSOR} in amd64) echo x86_64-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; *) - echo ${UNAME_MACHINE}-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; + echo ${UNAME_PROCESSOR}-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; esac exit ;; i*:CYGWIN*:*) @@ -807,6 +804,9 @@ EOF *:MINGW*:*) echo ${UNAME_MACHINE}-pc-mingw32 exit ;; + i*:MSYS*:*) + echo ${UNAME_MACHINE}-pc-msys + exit ;; i*:windows32*:*) # uname -m includes "-pc" on this system. echo ${UNAME_MACHINE}-mingw32 @@ -861,6 +861,13 @@ EOF i*86:Minix:*:*) echo ${UNAME_MACHINE}-pc-minix exit ;; + aarch64:Linux:*:*) + echo ${UNAME_MACHINE}-unknown-linux-gnu + exit ;; + aarch64_be:Linux:*:*) + UNAME_MACHINE=aarch64_be + echo ${UNAME_MACHINE}-unknown-linux-gnu + exit ;; alpha:Linux:*:*) case `sed -n '/^cpu model/s/^.*: \(.*\)/\1/p' < /proc/cpuinfo` in EV5) UNAME_MACHINE=alphaev5 ;; @@ -895,13 +902,16 @@ EOF echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; cris:Linux:*:*) - echo cris-axis-linux-gnu + echo ${UNAME_MACHINE}-axis-linux-gnu exit ;; crisv32:Linux:*:*) - echo crisv32-axis-linux-gnu + echo ${UNAME_MACHINE}-axis-linux-gnu exit ;; frv:Linux:*:*) - echo frv-unknown-linux-gnu + echo ${UNAME_MACHINE}-unknown-linux-gnu + exit ;; + hexagon:Linux:*:*) + echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; i*86:Linux:*:*) LIBC=gnu @@ -943,7 +953,7 @@ EOF test x"${CPU}" != x && { echo "${CPU}-unknown-linux-gnu"; exit; } ;; or32:Linux:*:*) - echo or32-unknown-linux-gnu + echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; padre:Linux:*:*) echo sparc-unknown-linux-gnu @@ -978,13 +988,13 @@ EOF echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; tile*:Linux:*:*) - echo ${UNAME_MACHINE}-tilera-linux-gnu + echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; vax:Linux:*:*) echo ${UNAME_MACHINE}-dec-linux-gnu exit ;; x86_64:Linux:*:*) - echo x86_64-unknown-linux-gnu + echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; xtensa*:Linux:*:*) echo ${UNAME_MACHINE}-unknown-linux-gnu @@ -1315,6 +1325,9 @@ EOF i*86:AROS:*:*) echo ${UNAME_MACHINE}-pc-aros exit ;; + x86_64:VMkernel:*:*) + echo ${UNAME_MACHINE}-unknown-esx + exit ;; esac #echo '(No uname command or uname output not recognized.)' 1>&2 @@ -2,9 +2,9 @@ # Configuration validation subroutine script. # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, # 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, -# 2011 Free Software Foundation, Inc. +# 2011, 2012 Free Software Foundation, Inc. -timestamp='2011-03-23' +timestamp='2012-04-18' # This file is (in principle) common to ALL GNU software. # The presence of a machine in this file suggests that SOME GNU software @@ -21,9 +21,7 @@ timestamp='2011-03-23' # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA -# 02110-1301, USA. +# along with this program; if not, see <http://www.gnu.org/licenses/>. # # As a special exception to the GNU General Public License, if you # distribute this file as part of a program that contains a @@ -76,8 +74,8 @@ version="\ GNU config.sub ($timestamp) Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free -Software Foundation, Inc. +2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 +Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." @@ -132,6 +130,10 @@ case $maybe_os in os=-$maybe_os basic_machine=`echo $1 | sed 's/^\(.*\)-\([^-]*-[^-]*\)$/\1/'` ;; + android-linux) + os=-linux-android + basic_machine=`echo $1 | sed 's/^\(.*\)-\([^-]*-[^-]*\)$/\1/'`-unknown + ;; *) basic_machine=`echo $1 | sed 's/-[^-]*$//'` if [ $basic_machine != $1 ] @@ -223,6 +225,12 @@ case $os in -isc*) basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'` ;; + -lynx*178) + os=-lynxos178 + ;; + -lynx*5) + os=-lynxos5 + ;; -lynx*) os=-lynxos ;; @@ -247,17 +255,22 @@ case $basic_machine in # Some are omitted here because they have special meanings below. 1750a | 580 \ | a29k \ + | aarch64 | aarch64_be \ | alpha | alphaev[4-8] | alphaev56 | alphaev6[78] | alphapca5[67] \ | alpha64 | alpha64ev[4-8] | alpha64ev56 | alpha64ev6[78] | alpha64pca5[67] \ | am33_2.0 \ | arc | arm | arm[bl]e | arme[lb] | armv[2345] | armv[345][lb] | avr | avr32 \ + | be32 | be64 \ | bfin \ | c4x | clipper \ | d10v | d30v | dlx | dsp16xx \ + | epiphany \ | fido | fr30 | frv \ | h8300 | h8500 | hppa | hppa1.[01] | hppa2.0 | hppa2.0[nw] | hppa64 \ + | hexagon \ | i370 | i860 | i960 | ia64 \ | ip2k | iq2000 \ + | le32 | le64 \ | lm32 \ | m32c | m32r | m32rle | m68000 | m68k | m88k \ | maxq | mb | microblaze | mcore | mep | metag \ @@ -291,7 +304,7 @@ case $basic_machine in | pdp10 | pdp11 | pj | pjl \ | powerpc | powerpc64 | powerpc64le | powerpcle \ | pyramid \ - | rx \ + | rl78 | rx \ | score \ | sh | sh[1234] | sh[24]a | sh[24]aeb | sh[23]e | sh[34]eb | sheb | shbe | shle | sh[1234]le | sh3ele \ | sh64 | sh64le \ @@ -300,7 +313,7 @@ case $basic_machine in | spu \ | tahoe | tic4x | tic54x | tic55x | tic6x | tic80 | tron \ | ubicom32 \ - | v850 | v850e \ + | v850 | v850e | v850e1 | v850e2 | v850es | v850e2v3 \ | we32k \ | x86 | xc16x | xstormy16 | xtensa \ | z8k | z80) @@ -315,8 +328,7 @@ case $basic_machine in c6x) basic_machine=tic6x-unknown ;; - m6811 | m68hc11 | m6812 | m68hc12 | picochip) - # Motorola 68HC11/12. + m6811 | m68hc11 | m6812 | m68hc12 | m68hcs12x | picochip) basic_machine=$basic_machine-unknown os=-none ;; @@ -329,7 +341,10 @@ case $basic_machine in strongarm | thumb | xscale) basic_machine=arm-unknown ;; - + xgate) + basic_machine=$basic_machine-unknown + os=-none + ;; xscaleeb) basic_machine=armeb-unknown ;; @@ -352,11 +367,13 @@ case $basic_machine in # Recognize the basic CPU types with company name. 580-* \ | a29k-* \ + | aarch64-* | aarch64_be-* \ | alpha-* | alphaev[4-8]-* | alphaev56-* | alphaev6[78]-* \ | alpha64-* | alpha64ev[4-8]-* | alpha64ev56-* | alpha64ev6[78]-* \ | alphapca5[67]-* | alpha64pca5[67]-* | arc-* \ | arm-* | armbe-* | armle-* | armeb-* | armv*-* \ | avr-* | avr32-* \ + | be32-* | be64-* \ | bfin-* | bs2000-* \ | c[123]* | c30-* | [cjt]90-* | c4x-* \ | clipper-* | craynv-* | cydra-* \ @@ -365,8 +382,10 @@ case $basic_machine in | f30[01]-* | f700-* | fido-* | fr30-* | frv-* | fx80-* \ | h8300-* | h8500-* \ | hppa-* | hppa1.[01]-* | hppa2.0-* | hppa2.0[nw]-* | hppa64-* \ + | hexagon-* \ | i*86-* | i860-* | i960-* | ia64-* \ | ip2k-* | iq2000-* \ + | le32-* | le64-* \ | lm32-* \ | m32c-* | m32r-* | m32rle-* \ | m68000-* | m680[012346]0-* | m68360-* | m683?2-* | m68k-* \ @@ -400,7 +419,7 @@ case $basic_machine in | pdp10-* | pdp11-* | pj-* | pjl-* | pn-* | power-* \ | powerpc-* | powerpc64-* | powerpc64le-* | powerpcle-* \ | pyramid-* \ - | romp-* | rs6000-* | rx-* \ + | rl78-* | romp-* | rs6000-* | rx-* \ | sh-* | sh[1234]-* | sh[24]a-* | sh[24]aeb-* | sh[23]e-* | sh[34]eb-* | sheb-* | shbe-* \ | shle-* | sh[1234]le-* | sh3ele-* | sh64-* | sh64le-* \ | sparc-* | sparc64-* | sparc64b-* | sparc64v-* | sparc86x-* | sparclet-* \ @@ -408,10 +427,11 @@ case $basic_machine in | sparcv8-* | sparcv9-* | sparcv9b-* | sparcv9v-* | sv1-* | sx?-* \ | tahoe-* \ | tic30-* | tic4x-* | tic54x-* | tic55x-* | tic6x-* | tic80-* \ - | tile-* | tilegx-* \ + | tile*-* \ | tron-* \ | ubicom32-* \ - | v850-* | v850e-* | vax-* \ + | v850-* | v850e-* | v850e1-* | v850es-* | v850e2-* | v850e2v3-* \ + | vax-* \ | we32k-* \ | x86-* | x86_64-* | xc16x-* | xps100-* \ | xstormy16-* | xtensa*-* \ @@ -711,7 +731,6 @@ case $basic_machine in i370-ibm* | ibm*) basic_machine=i370-ibm ;; -# I'm not sure what "Sysv32" means. Should this be sysv3.2? i*86v32) basic_machine=`echo $1 | sed -e 's/86.*/86-pc/'` os=-sysv32 @@ -808,10 +827,18 @@ case $basic_machine in ms1-*) basic_machine=`echo $basic_machine | sed -e 's/ms1-/mt-/'` ;; + msys) + basic_machine=i386-pc + os=-msys + ;; mvs) basic_machine=i370-ibm os=-mvs ;; + nacl) + basic_machine=le32-unknown + os=-nacl + ;; ncr3000) basic_machine=i486-ncr os=-sysv4 @@ -1120,13 +1147,8 @@ case $basic_machine in basic_machine=t90-cray os=-unicos ;; - # This must be matched before tile*. - tilegx*) - basic_machine=tilegx-unknown - os=-linux-gnu - ;; tile*) - basic_machine=tile-unknown + basic_machine=$basic_machine-unknown os=-linux-gnu ;; tx39) @@ -1336,7 +1358,7 @@ case $os in | -ptx* | -coff* | -ecoff* | -winnt* | -domain* | -vsta* \ | -udi* | -eabi* | -lites* | -ieee* | -go32* | -aux* \ | -chorusos* | -chorusrdb* | -cegcc* \ - | -cygwin* | -pe* | -psos* | -moss* | -proelf* | -rtems* \ + | -cygwin* | -msys* | -pe* | -psos* | -moss* | -proelf* | -rtems* \ | -mingw32* | -linux-gnu* | -linux-android* \ | -linux-newlib* | -linux-uclibc* \ | -uxpv* | -beos* | -mpeix* | -udk* \ @@ -1521,6 +1543,9 @@ case $basic_machine in c4x-* | tic4x-*) os=-coff ;; + hexagon-*) + os=-elf + ;; tic54x-*) os=-coff ;; @@ -1548,9 +1573,6 @@ case $basic_machine in ;; m68000-sun) os=-sunos3 - # This also exists in the configure program, but was not the - # default. - # os=-sunos4 ;; m68*-cisco) os=-aout @@ -1,6 +1,6 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.69 for dbus-glib 0.100. +# Generated by GNU Autoconf 2.69 for dbus-glib 0.100.2. # # Report bugs to <https://bugs.freedesktop.org/enter_bug.cgi?product=dbus&component=GLib>. # @@ -591,8 +591,8 @@ MAKEFLAGS= # Identity of this package. PACKAGE_NAME='dbus-glib' PACKAGE_TARNAME='dbus-glib' -PACKAGE_VERSION='0.100' -PACKAGE_STRING='dbus-glib 0.100' +PACKAGE_VERSION='0.100.2' +PACKAGE_STRING='dbus-glib 0.100.2' PACKAGE_BUGREPORT='https://bugs.freedesktop.org/enter_bug.cgi?product=dbus&component=GLib' PACKAGE_URL='' @@ -1393,7 +1393,7 @@ if test "$ac_init_help" = "long"; then # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures dbus-glib 0.100 to adapt to many kinds of systems. +\`configure' configures dbus-glib 0.100.2 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1463,7 +1463,7 @@ fi if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of dbus-glib 0.100:";; + short | recursive ) echo "Configuration of dbus-glib 0.100.2:";; esac cat <<\_ACEOF @@ -1608,7 +1608,7 @@ fi test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -dbus-glib configure 0.100 +dbus-glib configure 0.100.2 generated by GNU Autoconf 2.69 Copyright (C) 2012 Free Software Foundation, Inc. @@ -1977,7 +1977,7 @@ cat >config.log <<_ACEOF This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by dbus-glib $as_me 0.100, which was +It was created by dbus-glib $as_me 0.100.2, which was generated by GNU Autoconf 2.69. Invocation command line was $ $0 $@ @@ -2865,7 +2865,7 @@ fi # Define the identity of the package. PACKAGE='dbus-glib' - VERSION='0.100' + VERSION='0.100.2' cat >>confdefs.h <<_ACEOF @@ -5362,7 +5362,8 @@ else ;; *) lt_cv_sys_max_cmd_len=`(getconf ARG_MAX) 2> /dev/null` - if test -n "$lt_cv_sys_max_cmd_len"; then + if test -n "$lt_cv_sys_max_cmd_len" && \ + test undefined != "$lt_cv_sys_max_cmd_len"; then lt_cv_sys_max_cmd_len=`expr $lt_cv_sys_max_cmd_len \/ 4` lt_cv_sys_max_cmd_len=`expr $lt_cv_sys_max_cmd_len \* 3` else @@ -6898,7 +6899,14 @@ s390*-*linux*|s390*-*tpf*|sparc*-*linux*) LD="${LD-ld} -m elf_i386_fbsd" ;; x86_64-*linux*) - LD="${LD-ld} -m elf_i386" + case `/usr/bin/file conftest.o` in + *x86-64*) + LD="${LD-ld} -m elf32_x86_64" + ;; + *) + LD="${LD-ld} -m elf_i386" + ;; + esac ;; ppc64-*linux*|powerpc64-*linux*) LD="${LD-ld} -m elf32ppclinux" @@ -13514,7 +13522,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1 # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by dbus-glib $as_me 0.100, which was +This file was extended by dbus-glib $as_me 0.100.2, which was generated by GNU Autoconf 2.69. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -13580,7 +13588,7 @@ _ACEOF cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_version="\\ -dbus-glib config.status 0.100 +dbus-glib config.status 0.100.2 configured by $0, generated by GNU Autoconf 2.69, with options \\"\$ac_cs_config\\" diff --git a/configure.ac b/configure.ac index 8ea59e3..f9b032d 100644 --- a/configure.ac +++ b/configure.ac @@ -1,7 +1,7 @@ dnl -*- mode: m4 -*- AC_PREREQ(2.52) -AC_INIT([dbus-glib], [0.100], +AC_INIT([dbus-glib], [0.100.2], [https://bugs.freedesktop.org/enter_bug.cgi?product=dbus&component=GLib]) AC_CANONICAL_HOST diff --git a/dbus/Makefile.in b/dbus/Makefile.in index 16185c4..c67adfa 100644 --- a/dbus/Makefile.in +++ b/dbus/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/dbus/dbus-gproxy.c b/dbus/dbus-gproxy.c index 2fc52f9..c3ae9ec 100644 --- a/dbus/dbus-gproxy.c +++ b/dbus/dbus-gproxy.c @@ -1250,8 +1250,11 @@ dbus_g_proxy_manager_filter (DBusConnection *connection, GSList *tmp; const char *sender; + sender = dbus_message_get_sender (message); + /* First we handle NameOwnerChanged internally */ - if (dbus_message_is_signal (message, + if (g_strcmp0 (sender, DBUS_SERVICE_DBUS) == 0 && + dbus_message_is_signal (message, DBUS_INTERFACE_DBUS, "NameOwnerChanged")) { @@ -1280,8 +1283,6 @@ dbus_g_proxy_manager_filter (DBusConnection *connection, } } - sender = dbus_message_get_sender (message); - /* dbus spec requires these, libdbus validates */ g_assert (dbus_message_get_path (message) != NULL); g_assert (dbus_message_get_interface (message) != NULL); diff --git a/dbus/examples/Makefile.in b/dbus/examples/Makefile.in index e262bb3..0520332 100644 --- a/dbus/examples/Makefile.in +++ b/dbus/examples/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/dbus/examples/statemachine/Makefile.in b/dbus/examples/statemachine/Makefile.in index 13bea1a..953028f 100644 --- a/dbus/examples/statemachine/Makefile.in +++ b/dbus/examples/statemachine/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, @@ -1,10 +1,10 @@ #! /bin/sh # depcomp - compile a program generating dependencies as side-effects -scriptversion=2009-04-28.21; # UTC +scriptversion=2012-03-27.16; # UTC -# Copyright (C) 1999, 2000, 2003, 2004, 2005, 2006, 2007, 2009 Free -# Software Foundation, Inc. +# Copyright (C) 1999, 2000, 2003, 2004, 2005, 2006, 2007, 2009, 2010, +# 2011, 2012 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -28,7 +28,7 @@ scriptversion=2009-04-28.21; # UTC case $1 in '') - echo "$0: No command. Try \`$0 --help' for more information." 1>&2 + echo "$0: No command. Try '$0 --help' for more information." 1>&2 exit 1; ;; -h | --h*) @@ -40,11 +40,11 @@ as side-effects. Environment variables: depmode Dependency tracking mode. - source Source file read by `PROGRAMS ARGS'. - object Object file output by `PROGRAMS ARGS'. + source Source file read by 'PROGRAMS ARGS'. + object Object file output by 'PROGRAMS ARGS'. DEPDIR directory where to store dependencies. depfile Dependency file to output. - tmpdepfile Temporary file to use when outputing dependencies. + tmpdepfile Temporary file to use when outputting dependencies. libtool Whether libtool is used (yes/no). Report bugs to <bug-automake@gnu.org>. @@ -57,6 +57,12 @@ EOF ;; esac +# A tabulation character. +tab=' ' +# A newline character. +nl=' +' + if test -z "$depmode" || test -z "$source" || test -z "$object"; then echo "depcomp: Variables source, object and depmode must be set" 1>&2 exit 1 @@ -90,10 +96,24 @@ if test "$depmode" = msvcmsys; then # This is just like msvisualcpp but w/o cygpath translation. # Just convert the backslash-escaped backslashes to single forward # slashes to satisfy depend.m4 - cygpath_u="sed s,\\\\\\\\,/,g" + cygpath_u='sed s,\\\\,/,g' depmode=msvisualcpp fi +if test "$depmode" = msvc7msys; then + # This is just like msvc7 but w/o cygpath translation. + # Just convert the backslash-escaped backslashes to single forward + # slashes to satisfy depend.m4 + cygpath_u='sed s,\\\\,/,g' + depmode=msvc7 +fi + +if test "$depmode" = xlc; then + # IBM C/C++ Compilers xlc/xlC can output gcc-like dependency informations. + gccflag=-qmakedep=gcc,-MF + depmode=gcc +fi + case "$depmode" in gcc3) ## gcc 3 implements dependency tracking that does exactly what @@ -148,20 +168,21 @@ gcc) ## The second -e expression handles DOS-style file names with drive letters. sed -e 's/^[^:]*: / /' \ -e 's/^['$alpha']:\/[^:]*: / /' < "$tmpdepfile" >> "$depfile" -## This next piece of magic avoids the `deleted header file' problem. +## This next piece of magic avoids the "deleted header file" problem. ## The problem is that when a header file which appears in a .P file ## is deleted, the dependency causes make to die (because there is ## typically no way to rebuild the header). We avoid this by adding ## dummy dependencies for each header file. Too bad gcc doesn't do ## this for us directly. - tr ' ' ' -' < "$tmpdepfile" | -## Some versions of gcc put a space before the `:'. On the theory + tr ' ' "$nl" < "$tmpdepfile" | +## Some versions of gcc put a space before the ':'. On the theory ## that the space means something, we add a space to the output as -## well. +## well. hp depmode also adds that space, but also prefixes the VPATH +## to the object. Take care to not repeat it in the output. ## Some versions of the HPUX 10.20 sed can't process this invocation ## correctly. Breaking it into two sed invocations is a workaround. - sed -e 's/^\\$//' -e '/^$/d' -e '/:$/d' | sed -e 's/$/ :/' >> "$depfile" + sed -e 's/^\\$//' -e '/^$/d' -e "s|.*$object$||" -e '/:$/d' \ + | sed -e 's/$/ :/' >> "$depfile" rm -f "$tmpdepfile" ;; @@ -193,18 +214,15 @@ sgi) # clever and replace this with sed code, as IRIX sed won't handle # lines with more than a fixed number of characters (4096 in # IRIX 6.2 sed, 8192 in IRIX 6.5). We also remove comment lines; - # the IRIX cc adds comments like `#:fec' to the end of the + # the IRIX cc adds comments like '#:fec' to the end of the # dependency line. - tr ' ' ' -' < "$tmpdepfile" \ + tr ' ' "$nl" < "$tmpdepfile" \ | sed -e 's/^.*\.o://' -e 's/#.*$//' -e '/^$/ d' | \ - tr ' -' ' ' >> "$depfile" + tr "$nl" ' ' >> "$depfile" echo >> "$depfile" # The second pass generates a dummy entry for each header file. - tr ' ' ' -' < "$tmpdepfile" \ + tr ' ' "$nl" < "$tmpdepfile" \ | sed -e 's/^.*\.o://' -e 's/#.*$//' -e '/^$/ d' -e 's/$/:/' \ >> "$depfile" else @@ -216,10 +234,17 @@ sgi) rm -f "$tmpdepfile" ;; +xlc) + # This case exists only to let depend.m4 do its work. It works by + # looking at the text of this script. This case will never be run, + # since it is checked for above. + exit 1 + ;; + aix) # The C for AIX Compiler uses -M and outputs the dependencies # in a .u file. In older versions, this file always lives in the - # current directory. Also, the AIX compiler puts `$object:' at the + # current directory. Also, the AIX compiler puts '$object:' at the # start of each line; $object doesn't have directory information. # Version 6 uses the directory in both cases. dir=`echo "$object" | sed -e 's|/[^/]*$|/|'` @@ -249,12 +274,11 @@ aix) test -f "$tmpdepfile" && break done if test -f "$tmpdepfile"; then - # Each line is of the form `foo.o: dependent.h'. + # Each line is of the form 'foo.o: dependent.h'. # Do two passes, one to just change these to - # `$object: dependent.h' and one to simply `dependent.h:'. + # '$object: dependent.h' and one to simply 'dependent.h:'. sed -e "s,^.*\.[a-z]*:,$object:," < "$tmpdepfile" > "$depfile" - # That's a tab and a space in the []. - sed -e 's,^.*\.[a-z]*:[ ]*,,' -e 's,$,:,' < "$tmpdepfile" >> "$depfile" + sed -e 's,^.*\.[a-z]*:['"$tab"' ]*,,' -e 's,$,:,' < "$tmpdepfile" >> "$depfile" else # The sourcefile does not contain any dependencies, so just # store a dummy comment line, to avoid errors with the Makefile @@ -265,23 +289,26 @@ aix) ;; icc) - # Intel's C compiler understands `-MD -MF file'. However on - # icc -MD -MF foo.d -c -o sub/foo.o sub/foo.c + # Intel's C compiler anf tcc (Tiny C Compiler) understand '-MD -MF file'. + # However on + # $CC -MD -MF foo.d -c -o sub/foo.o sub/foo.c # ICC 7.0 will fill foo.d with something like # foo.o: sub/foo.c # foo.o: sub/foo.h - # which is wrong. We want: + # which is wrong. We want # sub/foo.o: sub/foo.c # sub/foo.o: sub/foo.h # sub/foo.c: # sub/foo.h: # ICC 7.1 will output # foo.o: sub/foo.c sub/foo.h - # and will wrap long lines using \ : + # and will wrap long lines using '\': # foo.o: sub/foo.c ... \ # sub/foo.h ... \ # ... - + # tcc 0.9.26 (FIXME still under development at the moment of writing) + # will emit a similar output, but also prepend the continuation lines + # with horizontal tabulation characters. "$@" -MD -MF "$tmpdepfile" stat=$? if test $stat -eq 0; then : @@ -290,15 +317,21 @@ icc) exit $stat fi rm -f "$depfile" - # Each line is of the form `foo.o: dependent.h', - # or `foo.o: dep1.h dep2.h \', or ` dep3.h dep4.h \'. + # Each line is of the form 'foo.o: dependent.h', + # or 'foo.o: dep1.h dep2.h \', or ' dep3.h dep4.h \'. # Do two passes, one to just change these to - # `$object: dependent.h' and one to simply `dependent.h:'. - sed "s,^[^:]*:,$object :," < "$tmpdepfile" > "$depfile" - # Some versions of the HPUX 10.20 sed can't process this invocation - # correctly. Breaking it into two sed invocations is a workaround. - sed 's,^[^:]*: \(.*\)$,\1,;s/^\\$//;/^$/d;/:$/d' < "$tmpdepfile" | - sed -e 's/$/ :/' >> "$depfile" + # '$object: dependent.h' and one to simply 'dependent.h:'. + sed -e "s/^[ $tab][ $tab]*/ /" -e "s,^[^:]*:,$object :," \ + < "$tmpdepfile" > "$depfile" + sed ' + s/[ '"$tab"'][ '"$tab"']*/ /g + s/^ *// + s/ *\\*$// + s/^[^:]*: *// + /^$/d + /:$/d + s/$/ :/ + ' < "$tmpdepfile" >> "$depfile" rm -f "$tmpdepfile" ;; @@ -334,7 +367,7 @@ hp2) done if test -f "$tmpdepfile"; then sed -e "s,^.*\.[a-z]*:,$object:," "$tmpdepfile" > "$depfile" - # Add `dependent.h:' lines. + # Add 'dependent.h:' lines. sed -ne '2,${ s/^ *// s/ \\*$// @@ -349,9 +382,9 @@ hp2) tru64) # The Tru64 compiler uses -MD to generate dependencies as a side - # effect. `cc -MD -o foo.o ...' puts the dependencies into `foo.o.d'. + # effect. 'cc -MD -o foo.o ...' puts the dependencies into 'foo.o.d'. # At least on Alpha/Redhat 6.1, Compaq CCC V6.2-504 seems to put - # dependencies in `foo.d' instead, so we check for that too. + # dependencies in 'foo.d' instead, so we check for that too. # Subdirectories are respected. dir=`echo "$object" | sed -e 's|/[^/]*$|/|'` test "x$dir" = "x$object" && dir= @@ -397,14 +430,59 @@ tru64) done if test -f "$tmpdepfile"; then sed -e "s,^.*\.[a-z]*:,$object:," < "$tmpdepfile" > "$depfile" - # That's a tab and a space in the []. - sed -e 's,^.*\.[a-z]*:[ ]*,,' -e 's,$,:,' < "$tmpdepfile" >> "$depfile" + sed -e 's,^.*\.[a-z]*:['"$tab"' ]*,,' -e 's,$,:,' < "$tmpdepfile" >> "$depfile" else echo "#dummy" > "$depfile" fi rm -f "$tmpdepfile" ;; +msvc7) + if test "$libtool" = yes; then + showIncludes=-Wc,-showIncludes + else + showIncludes=-showIncludes + fi + "$@" $showIncludes > "$tmpdepfile" + stat=$? + grep -v '^Note: including file: ' "$tmpdepfile" + if test "$stat" = 0; then : + else + rm -f "$tmpdepfile" + exit $stat + fi + rm -f "$depfile" + echo "$object : \\" > "$depfile" + # The first sed program below extracts the file names and escapes + # backslashes for cygpath. The second sed program outputs the file + # name when reading, but also accumulates all include files in the + # hold buffer in order to output them again at the end. This only + # works with sed implementations that can handle large buffers. + sed < "$tmpdepfile" -n ' +/^Note: including file: *\(.*\)/ { + s//\1/ + s/\\/\\\\/g + p +}' | $cygpath_u | sort -u | sed -n ' +s/ /\\ /g +s/\(.*\)/'"$tab"'\1 \\/p +s/.\(.*\) \\/\1:/ +H +$ { + s/.*/'"$tab"'/ + G + p +}' >> "$depfile" + rm -f "$tmpdepfile" + ;; + +msvc7msys) + # This case exists only to let depend.m4 do its work. It works by + # looking at the text of this script. This case will never be run, + # since it is checked for above. + exit 1 + ;; + #nosideeffect) # This comment above is used by automake to tell side-effect # dependency tracking mechanisms from slower ones. @@ -422,7 +500,7 @@ dashmstdout) shift fi - # Remove `-o $object'. + # Remove '-o $object'. IFS=" " for arg do @@ -442,15 +520,14 @@ dashmstdout) done test -z "$dashmflag" && dashmflag=-M - # Require at least two characters before searching for `:' + # Require at least two characters before searching for ':' # in the target name. This is to cope with DOS-style filenames: - # a dependency such as `c:/foo/bar' could be seen as target `c' otherwise. + # a dependency such as 'c:/foo/bar' could be seen as target 'c' otherwise. "$@" $dashmflag | - sed 's:^[ ]*[^: ][^:][^:]*\:[ ]*:'"$object"'\: :' > "$tmpdepfile" + sed 's:^['"$tab"' ]*[^:'"$tab"' ][^:][^:]*\:['"$tab"' ]*:'"$object"'\: :' > "$tmpdepfile" rm -f "$depfile" cat < "$tmpdepfile" > "$depfile" - tr ' ' ' -' < "$tmpdepfile" | \ + tr ' ' "$nl" < "$tmpdepfile" | \ ## Some versions of the HPUX 10.20 sed can't process this invocation ## correctly. Breaking it into two sed invocations is a workaround. sed -e 's/^\\$//' -e '/^$/d' -e '/:$/d' | sed -e 's/$/ :/' >> "$depfile" @@ -503,9 +580,10 @@ makedepend) touch "$tmpdepfile" ${MAKEDEPEND-makedepend} -o"$obj_suffix" -f"$tmpdepfile" "$@" rm -f "$depfile" - cat < "$tmpdepfile" > "$depfile" - sed '1,2d' "$tmpdepfile" | tr ' ' ' -' | \ + # makedepend may prepend the VPATH from the source file name to the object. + # No need to regex-escape $object, excess matching of '.' is harmless. + sed "s|^.*\($object *:\)|\1|" "$tmpdepfile" > "$depfile" + sed '1,2d' "$tmpdepfile" | tr ' ' "$nl" | \ ## Some versions of the HPUX 10.20 sed can't process this invocation ## correctly. Breaking it into two sed invocations is a workaround. sed -e 's/^\\$//' -e '/^$/d' -e '/:$/d' | sed -e 's/$/ :/' >> "$depfile" @@ -525,7 +603,7 @@ cpp) shift fi - # Remove `-o $object'. + # Remove '-o $object'. IFS=" " for arg do @@ -594,8 +672,8 @@ msvisualcpp) sed -n '/^#line [0-9][0-9]* "\([^"]*\)"/ s::\1:p' | $cygpath_u | sort -u > "$tmpdepfile" rm -f "$depfile" echo "$object : \\" > "$depfile" - sed < "$tmpdepfile" -n -e 's% %\\ %g' -e '/^\(.*\)$/ s:: \1 \\:p' >> "$depfile" - echo " " >> "$depfile" + sed < "$tmpdepfile" -n -e 's% %\\ %g' -e '/^\(.*\)$/ s::'"$tab"'\1 \\:p' >> "$depfile" + echo "$tab" >> "$depfile" sed < "$tmpdepfile" -n -e 's% %\\ %g' -e '/^\(.*\)$/ s::\1\::p' >> "$depfile" rm -f "$tmpdepfile" ;; diff --git a/doc/Makefile.in b/doc/Makefile.in index df0d8ae..2649361 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/doc/reference/Makefile.in b/doc/reference/Makefile.in index dea6d06..d005854 100644 --- a/doc/reference/Makefile.in +++ b/doc/reference/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/doc/reference/dbus-glib-sections.txt b/doc/reference/dbus-glib-sections.txt index 5c36424..90015c3 100644 --- a/doc/reference/dbus-glib-sections.txt +++ b/doc/reference/dbus-glib-sections.txt @@ -1,178 +1,200 @@ <SECTION> -<FILE>dbus-glib</FILE> -<TITLE>DBusGProxy</TITLE> -DBUS_GERROR -DBUS_INSIDE_DBUS_GLIB_H -DBUS_TYPE_G_BOOLEAN_ARRAY -DBUS_TYPE_G_CONNECTION -DBUS_TYPE_G_INT64_ARRAY -DBUS_TYPE_G_INT_ARRAY -DBUS_TYPE_G_MESSAGE -DBUS_TYPE_G_OBJECT_ARRAY -DBUS_TYPE_G_OBJECT_PATH -DBUS_TYPE_G_SIGNATURE -DBUS_TYPE_G_STRING_STRING_HASHTABLE -DBUS_TYPE_G_UCHAR_ARRAY -DBUS_TYPE_G_UINT64_ARRAY -DBUS_TYPE_G_UINT_ARRAY -DBusGAsyncData +<FILE>dbus-gconnection</FILE> +<TITLE>DBusGConnection</TITLE> +<INCLUDE>dbus/dbus-glib.h</INCLUDE> DBusGConnection -DBusGError -DBusGMessage -DBusGMethodInfo -DBusGMethodInvocation -DBusGObjectInfo -DBusGObjectPath -DBusGProxy -DBusGProxyCall -DBusGProxyCallNotify -DBusGProxyClass -DBusGSignature +DBUS_TYPE_G_CONNECTION dbus_g_bus_get dbus_g_bus_get_private -dbus_g_connection_flush -dbus_g_connection_get_g_type -dbus_g_connection_lookup_g_object +dbus_g_thread_init dbus_g_connection_open dbus_g_connection_ref -dbus_g_connection_register_g_object dbus_g_connection_unref +dbus_g_connection_flush +dbus_g_connection_get_connection +dbus_g_connection_register_g_object dbus_g_connection_unregister_g_object -dbus_g_error_domain_register -dbus_g_error_get_name -dbus_g_error_has_name -dbus_g_error_quark -dbus_g_message_get_g_type +dbus_g_connection_lookup_g_object +<SUBSECTION Standard> +dbus_g_connection_get_g_type +</SECTION> + +<SECTION> +<FILE>dbus-gobject</FILE> +<TITLE>DBus GObject related functions</TITLE> +<INCLUDE>dbus/dbus-glib.h</INCLUDE> +DBusGObjectInfo +dbus_g_object_type_install_info +dbus_g_object_type_register_shadow_property +dbus_g_object_path_get_g_type +dbus_g_object_register_marshaller +dbus_g_object_register_marshaller_array +dbus_glib_global_set_disable_legacy_property_access +</SECTION> + +<SECTION> +<FILE>dbus-gmessage</FILE> +<TITLE>DBusGMessage</TITLE> +<INCLUDE>dbus/dbus-glib.h</INCLUDE> +DBusGMessage +DBUS_TYPE_G_MESSAGE dbus_g_message_ref dbus_g_message_unref +dbus_g_message_get_message +<SUBSECTION Standard> +dbus_g_message_get_g_type +</SECTION> + +<SECTION> +<FILE>dbus-gmethod</FILE> +<TITLE>DBusGMethod</TITLE> +<INCLUDE>dbus/dbus-glib.h</INCLUDE> +DBusGMethodInfo +DBusGMethodInvocation +dbus_g_method_get_sender +dbus_g_method_get_reply +dbus_g_method_send_reply dbus_g_method_return dbus_g_method_return_error -dbus_g_object_path_get_g_type -dbus_g_object_register_marshaller -dbus_g_object_register_marshaller_array -dbus_g_object_type_install_info -dbus_g_object_type_register_shadow_property +</SECTION> + +<SECTION> +<FILE>dbus-gerror</FILE> +<TITLE>DBusGError</TITLE> +<INCLUDE>dbus/dbus-glib.h</INCLUDE> +DBusGError +dbus_g_error_has_name +dbus_g_error_get_name +dbus_g_error_domain_register +DBUS_GERROR +<SUBSECTION Standard> +dbus_g_error_quark +</SECTION> + +<SECTION> +<FILE>dbus-gproxy</FILE> +<TITLE>DBusGProxy</TITLE> +<INCLUDE>dbus/dbus-glib.h</INCLUDE> +DBusGProxy +DBusGProxyCall +DBusGProxyCallNotify +dbus_g_proxy_new_for_name +dbus_g_proxy_new_for_name_owner +dbus_g_proxy_new_from_proxy +dbus_g_proxy_new_for_peer +dbus_g_proxy_set_interface +dbus_g_proxy_get_path +dbus_g_proxy_get_bus_name +dbus_g_proxy_get_interface dbus_g_proxy_add_signal -dbus_g_proxy_begin_call -dbus_g_proxy_begin_call_with_timeout -dbus_g_proxy_call -dbus_g_proxy_call_no_reply -dbus_g_proxy_call_with_timeout -dbus_g_proxy_cancel_call dbus_g_proxy_connect_signal dbus_g_proxy_disconnect_signal +dbus_g_proxy_send +dbus_g_proxy_call +dbus_g_proxy_call_with_timeout +dbus_g_proxy_call_no_reply +dbus_g_proxy_begin_call +dbus_g_proxy_begin_call_with_timeout dbus_g_proxy_end_call -dbus_g_proxy_get_bus_name -dbus_g_proxy_get_interface -dbus_g_proxy_get_path -dbus_g_proxy_new_for_name -dbus_g_proxy_new_for_name_owner -dbus_g_proxy_new_for_peer -dbus_g_proxy_new_from_proxy +dbus_g_proxy_cancel_call dbus_g_proxy_set_default_timeout -dbus_g_proxy_set_interface -dbus_g_signature_get_g_type -dbus_g_thread_init -dbus_glib_global_set_disable_legacy_property_access <SUBSECTION Standard> DBUS_G_PROXY -DBUS_G_PROXY_CLASS -DBUS_G_PROXY_GET_CLASS DBUS_IS_G_PROXY -DBUS_IS_G_PROXY_CLASS DBUS_TYPE_G_PROXY dbus_g_proxy_get_type +DBUS_G_PROXY_CLASS +DBUS_IS_G_PROXY_CLASS +DBUS_G_PROXY_GET_CLASS +<SUBSECTION Private> +DBusGAsyncData </SECTION> <SECTION> <FILE>dbus-glib-lowlevel</FILE> +<TITLE>DBus GLib low level</TITLE> +<INCLUDE>dbus/dbus-glib-lowlevel.h</INCLUDE> +dbus_set_g_error +dbus_connection_setup_with_g_main +dbus_connection_get_g_connection +dbus_server_setup_with_g_main DBUS_TYPE_CONNECTION DBUS_TYPE_MESSAGE -dbus_connection_get_g_connection +<SUBSECTION Standard> dbus_connection_get_g_type -dbus_connection_setup_with_g_main -dbus_g_connection_get_connection -dbus_g_message_get_message -dbus_g_method_get_reply -dbus_g_method_get_sender -dbus_g_method_send_reply -dbus_g_proxy_send dbus_message_get_g_type -dbus_server_setup_with_g_main -dbus_set_g_error -</SECTION> - -<SECTION> -<FILE>dbus-gobject</FILE> - -</SECTION> - -<SECTION> -<FILE>dbus-gtool-test</FILE> - +<SUBSECTION Private> +DBUS_INSIDE_DBUS_GLIB_H </SECTION> <SECTION> <FILE>dbus-gtype-specialized</FILE> +<TITLE>Specializable GType System</TITLE> +<INCLUDE>dbus/dbus-glib.h</INCLUDE> +DBusGTypeSpecializedCollectionIterator +DBusGTypeSpecializedMapIterator DBusGTypeSpecializedAppendContext -DBusGTypeSpecializedCollectionAppendFunc -DBusGTypeSpecializedCollectionEndAppendFunc +DBusGTypeSpecializedConstructor +DBusGTypeSpecializedFreeFunc +DBusGTypeSpecializedCopyFunc +DBusGTypeSpecializedVtable DBusGTypeSpecializedCollectionFixedAccessorFunc -DBusGTypeSpecializedCollectionIterator DBusGTypeSpecializedCollectionIteratorFunc +DBusGTypeSpecializedCollectionAppendFunc +DBusGTypeSpecializedCollectionEndAppendFunc DBusGTypeSpecializedCollectionVtable -DBusGTypeSpecializedConstructor -DBusGTypeSpecializedCopyFunc -DBusGTypeSpecializedFreeFunc -DBusGTypeSpecializedMapAppendFunc -DBusGTypeSpecializedMapIterator DBusGTypeSpecializedMapIteratorFunc +DBusGTypeSpecializedMapAppendFunc DBusGTypeSpecializedMapVtable DBusGTypeSpecializedStructGetMember DBusGTypeSpecializedStructSetMember DBusGTypeSpecializedStructVtable -DBusGTypeSpecializedVtable -dbus_g_type_collection_get_fixed -dbus_g_type_collection_peek_vtable -dbus_g_type_collection_value_iterate dbus_g_type_get_collection -dbus_g_type_get_collection_specialization dbus_g_type_get_map -dbus_g_type_get_map_key_specialization -dbus_g_type_get_map_value_specialization -dbus_g_type_get_struct -dbus_g_type_get_struct_member_type -dbus_g_type_get_struct_size dbus_g_type_get_structv +dbus_g_type_get_struct dbus_g_type_is_collection dbus_g_type_is_map dbus_g_type_is_struct -dbus_g_type_map_peek_vtable -dbus_g_type_map_value_iterate -dbus_g_type_register_collection -dbus_g_type_register_map -dbus_g_type_register_struct -dbus_g_type_specialized_collection_append -dbus_g_type_specialized_collection_end_append +dbus_g_type_get_collection_specialization +dbus_g_type_get_map_key_specialization +dbus_g_type_get_map_value_specialization +dbus_g_type_get_struct_member_type +dbus_g_type_get_struct_size dbus_g_type_specialized_construct -dbus_g_type_specialized_init dbus_g_type_specialized_init_append +dbus_g_type_specialized_collection_append +dbus_g_type_specialized_collection_end_append dbus_g_type_specialized_map_append -dbus_g_type_struct_get +dbus_g_type_collection_get_fixed +dbus_g_type_collection_value_iterate +dbus_g_type_map_value_iterate dbus_g_type_struct_get_member -dbus_g_type_struct_peek_vtable -dbus_g_type_struct_set dbus_g_type_struct_set_member +dbus_g_type_struct_get +dbus_g_type_struct_set +dbus_g_type_specialized_init +dbus_g_type_register_collection +dbus_g_type_register_map +dbus_g_type_map_peek_vtable +dbus_g_type_collection_peek_vtable +dbus_g_type_struct_peek_vtable +dbus_g_type_register_struct dbus_g_value_build_g_variant -</SECTION> - -<SECTION> -<FILE>dbus-gtype-specialized-priv</FILE> - -</SECTION> - -<SECTION> -<FILE>dbus-gvalue-parse-variant</FILE> dbus_g_value_parse_g_variant +DBUS_TYPE_G_BOOLEAN_ARRAY +DBUS_TYPE_G_UCHAR_ARRAY +DBUS_TYPE_G_UINT_ARRAY +DBUS_TYPE_G_INT_ARRAY +DBUS_TYPE_G_UINT64_ARRAY +DBUS_TYPE_G_INT64_ARRAY +DBUS_TYPE_G_OBJECT_ARRAY +DBUS_TYPE_G_STRING_STRING_HASHTABLE +DBusGSignature +DBUS_TYPE_G_SIGNATURE +DBusGObjectPath +DBUS_TYPE_G_OBJECT_PATH +<SUBSECTION Private> +dbus_g_object_path_get_g_type +dbus_g_signature_get_g_type </SECTION> - diff --git a/doc/reference/dbus-glib.types b/doc/reference/dbus-glib.types index aa5dd5e..e69de29 100644 --- a/doc/reference/dbus-glib.types +++ b/doc/reference/dbus-glib.types @@ -1 +0,0 @@ -dbus_g_proxy_get_type diff --git a/doc/reference/html/ch01.html b/doc/reference/html/ch01.html index 9f901fc..f440dee 100644 --- a/doc/reference/html/ch01.html +++ b/doc/reference/html/ch01.html @@ -21,7 +21,7 @@ </tr></table> <div class="chapter"> <div class="titlepage"><div><div><h2 class="title"> -<a name="idp268848"></a>Introduction</h2></div></div></div> +<a name="idp744992"></a>Introduction</h2></div></div></div> <p>D-Bus is a message bus system, a simple way for applications to talk to one another.</p> <p>D-Bus supplies both a system daemon (for events such as "new diff --git a/doc/reference/html/ch02.html b/doc/reference/html/ch02.html index 0ff5269..5984dd4 100644 --- a/doc/reference/html/ch02.html +++ b/doc/reference/html/ch02.html @@ -7,7 +7,7 @@ <link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> <link rel="up" href="index.html" title="D-Bus GLib bindings - Reference Manual"> <link rel="prev" href="ch01.html" title="Introduction"> -<link rel="next" href="dbus-glib-dbus-gtype-specialized.html" title="Specializable GType System"> +<link rel="next" href="dbus-glib-DBusGConnection.html" title="DBusGConnection"> <meta name="generator" content="GTK-Doc V1.18 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> @@ -17,18 +17,36 @@ <td> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> <th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> -<td><a accesskey="n" href="dbus-glib-dbus-gtype-specialized.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +<td><a accesskey="n" href="dbus-glib-DBusGConnection.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> </tr></table> <div class="chapter"> <div class="titlepage"><div><div><h2 class="title"> -<a name="idp270192"></a>API Reference</h2></div></div></div> +<a name="idp748720"></a>API Reference</h2></div></div></div> <div class="toc"><dl> <dt><span class="sect1"><a href="ch02.html#api-overview">API for using D-BUS with GLib</a></span></dt> <dt> -<span class="refentrytitle"><a href="dbus-glib-dbus-gtype-specialized.html">Specializable GType System</a></span><span class="refpurpose"> — Specialized GTypes</span> +<span class="refentrytitle"><a href="dbus-glib-DBusGConnection.html">DBusGConnection</a></span><span class="refpurpose"> — DBus Connection</span> </dt> <dt> -<span class="refentrytitle"><a href="dbus-glib-dbus-glib-lowlevel.html">DBus GLib low level</a></span><span class="refpurpose"> — DBus lower level functions</span> +<span class="refentrytitle"><a href="dbus-glib-DBus-GObject-related-functions.html">DBus GObject related functions</a></span><span class="refpurpose"> — Exporting a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> remotely</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGMessage.html">DBusGMessage</a></span><span class="refpurpose"> — DBus Message</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGMethod.html">DBusGMethod</a></span><span class="refpurpose"> — GMethod Info & Invocation</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGError.html">DBusGError</a></span><span class="refpurpose"> — DBus GError</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGProxy.html">DBusGProxy</a></span><span class="refpurpose"> — DBus Proxy</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-Specializable-GType-System.html">Specializable GType System</a></span><span class="refpurpose"> — Specialized GTypes</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBus-GLib-low-level.html">DBus GLib low level</a></span><span class="refpurpose"> — DBus lower level functions</span> </dt> </dl></div> <div class="sect1"> @@ -42,7 +60,6 @@ information.</p> <p>To manipulate remote objects, use DBusGProxy. </p> </div> -<span style="color: red"><xi:include></xi:include></span><span style="color: red"><xi:include></xi:include></span><span style="color: red"><xi:include></xi:include></span><span style="color: red"><xi:include></xi:include></span><span style="color: red"><xi:include></xi:include></span><span style="color: red"><xi:include></xi:include></span> </div> <div class="footer"> <hr> diff --git a/doc/reference/html/ch03.html b/doc/reference/html/ch03.html index 8945a6a..bc9b923 100644 --- a/doc/reference/html/ch03.html +++ b/doc/reference/html/ch03.html @@ -6,14 +6,14 @@ <meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> <link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> <link rel="up" href="index.html" title="D-Bus GLib bindings - Reference Manual"> -<link rel="prev" href="dbus-glib-dbus-glib-lowlevel.html" title="DBus GLib low level"> +<link rel="prev" href="dbus-glib-DBus-GLib-low-level.html" title="DBus GLib low level"> <link rel="next" href="dbus-binding-tool.html" title="dbus-binding-tool"> <meta name="generator" content="GTK-Doc V1.18 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> -<td><a accesskey="p" href="dbus-glib-dbus-glib-lowlevel.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="p" href="dbus-glib-DBus-GLib-low-level.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> <td> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> <th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> @@ -21,7 +21,7 @@ </tr></table> <div class="chapter"> <div class="titlepage"><div><div><h2 class="title"> -<a name="idp4149376"></a>Tools Reference</h2></div></div></div> +<a name="idp3754816"></a>Tools Reference</h2></div></div></div> <div class="toc"><dl><dt> <span class="refentrytitle"><a href="dbus-binding-tool.html">dbus-binding-tool</a></span><span class="refpurpose"> — C language GLib bindings generation utility</span> </dt></dl></div> diff --git a/doc/reference/html/dbus-binding-tool.html b/doc/reference/html/dbus-binding-tool.html index 586dbe6..2823818 100644 --- a/doc/reference/html/dbus-binding-tool.html +++ b/doc/reference/html/dbus-binding-tool.html @@ -32,16 +32,16 @@ <div class="cmdsynopsis"><p>[options...] [files...]</p></div> </div> <div class="refsect1"> -<a name="idp5164656"></a><h2>Description</h2> +<a name="idp3759776"></a><h2>Description</h2> <p><span class="command"><strong>dbus-binding-tool</strong></span> bla bla bla </p> </div> <div class="refsect1"> -<a name="idp5166176"></a><h2>Invocation</h2> +<a name="idp4771024"></a><h2>Invocation</h2> <p><span class="command"><strong>dbus-binding-tool</strong></span> bla bla bla </p> <div class="refsect2"> -<a name="idp5167568"></a><h3>Options</h3> +<a name="idp4772416"></a><h3>Options</h3> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> @@ -68,7 +68,7 @@ Print version and exit. </div> </div> <div class="refsect1"> -<a name="idp5173200"></a><h2>See also</h2> +<a name="idp4778048"></a><h2>See also</h2> <p><span class="command"><strong>glib-genmarshal</strong></span>(1) </p> </div> diff --git a/doc/reference/html/dbus-glib-DBus-GLib-low-level.html b/doc/reference/html/dbus-glib-DBus-GLib-low-level.html new file mode 100644 index 0000000..3457403 --- /dev/null +++ b/doc/reference/html/dbus-glib-DBus-GLib-low-level.html @@ -0,0 +1,248 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>DBus GLib low level</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> +<link rel="up" href="ch02.html" title="API Reference"> +<link rel="prev" href="dbus-glib-Specializable-GType-System.html" title="Specializable GType System"> +<link rel="next" href="ch03.html" title="Tools Reference"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="dbus-glib-Specializable-GType-System.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> +<td><a accesskey="n" href="ch03.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#dbus-glib-DBus-GLib-low-level.synopsis" class="shortcut">Top</a> +  | + <a href="#dbus-glib-DBus-GLib-low-level.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="dbus-glib-DBus-GLib-low-level"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="dbus-glib-DBus-GLib-low-level.top_of_page"></a>DBus GLib low level</span></h2> +<p>DBus GLib low level — DBus lower level functions</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="dbus-glib-DBus-GLib-low-level.stability-level"></a><h2>Stability Level</h2> +Unstable, unless otherwise indicated +</div> +<div class="refsynopsisdiv"> +<a name="dbus-glib-DBus-GLib-low-level.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib-lowlevel.h> + +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GLib-low-level.html#dbus-set-g-error" title="dbus_set_g_error ()">dbus_set_g_error</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **gerror</code></em>, + <em class="parameter"><code><span class="type">DBusError</span> *derror</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GLib-low-level.html#dbus-connection-setup-with-g-main" title="dbus_connection_setup_with_g_main ()">dbus_connection_setup_with_g_main</a> (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>); +<a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * <a class="link" href="dbus-glib-DBus-GLib-low-level.html#dbus-connection-get-g-connection" title="dbus_connection_get_g_connection ()">dbus_connection_get_g_connection</a> (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GLib-low-level.html#dbus-server-setup-with-g-main" title="dbus_server_setup_with_g_main ()">dbus_server_setup_with_g_main</a> (<em class="parameter"><code><span class="type">DBusServer</span> *server</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>); +#define <a class="link" href="dbus-glib-DBus-GLib-low-level.html#DBUS-TYPE-CONNECTION:CAPS" title="DBUS_TYPE_CONNECTION">DBUS_TYPE_CONNECTION</a> +#define <a class="link" href="dbus-glib-DBus-GLib-low-level.html#DBUS-TYPE-MESSAGE:CAPS" title="DBUS_TYPE_MESSAGE">DBUS_TYPE_MESSAGE</a> +</pre> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBus-GLib-low-level.description"></a><h2>Description</h2> +<p> +These functions can be used to access lower level of DBus. +</p> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBus-GLib-low-level.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="dbus-set-g-error"></a><h3>dbus_set_g_error ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_set_g_error (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **gerror</code></em>, + <em class="parameter"><code><span class="type">DBusError</span> *derror</code></em>);</pre> +<p> +Store the information from a DBus method error return into a +GError. For the normal case of an arbitrary remote process, +the error code will be DBUS_GERROR_REMOTE_EXCEPTION. Now, +DBus errors have two components; a message and a "name". +The former is an arbitrary (normally American English) string. +The second is a string like com.example.FooFailure which +programs can use as a conditional source. Because a GError +only has one string, we use a hack to encode both values: +</p> +<p> +<human readable string><null><error name><null> +</p> +<p> +You can use the following code to retrieve both values: +</p> +<p> +</p> +<div class="informalexample"> + <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> + <tbody> + <tr> + <td class="listing_lines" align="right"><pre>1 +2 +3</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">const char</span> <span class="gtkdoc opt">*</span>msg <span class="gtkdoc opt">=</span> error<span class="gtkdoc opt">-></span>message<span class="gtkdoc opt">;</span> +<span class="gtkdoc kwb">size_t</span> len <span class="gtkdoc opt">=</span> <span class="function">strlen</span><span class="gtkdoc opt">(</span>msg<span class="gtkdoc opt">);</span> +<span class="gtkdoc kwb">const char</span> <span class="gtkdoc opt">*</span>error_name <span class="gtkdoc opt">=</span> msg<span class="gtkdoc opt">+</span>len<span class="gtkdoc opt">+</span><span class="number">1</span><span class="gtkdoc opt">;</span></pre></td> + </tr> + </tbody> + </table> +</div> + +<p> +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>gerror</code></em> :</span></p></td> +<td>an error</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>derror</code></em> :</span></p></td> +<td>a <span class="type">DBusError</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-connection-setup-with-g-main"></a><h3>dbus_connection_setup_with_g_main ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_connection_setup_with_g_main (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>);</pre> +<p> +Sets the watch and timeout functions of a <span class="type">DBusConnection</span> +to integrate the connection with the GLib main loop. +Pass in <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> unless you're +doing something specialized. +</p> +<p> +If called twice for the same context, does nothing the second +time. If called once with context A and once with context B, +context B replaces context A as the context monitoring the +connection. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the connection</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for default context</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-connection-get-g-connection"></a><h3>dbus_connection_get_g_connection ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * dbus_connection_get_g_connection (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>);</pre> +<p> +Get the <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> corresponding to this <span class="type">DBusConnection</span>. This only +makes sense if the <span class="type">DBusConnection</span> was originally a <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> that was +registered with the GLib main loop. The return value does not have its +refcount incremented. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>a <span class="type">DBusConnection</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a></td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-server-setup-with-g-main"></a><h3>dbus_server_setup_with_g_main ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_server_setup_with_g_main (<em class="parameter"><code><span class="type">DBusServer</span> *server</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>);</pre> +<p> +Sets the watch and timeout functions of a <span class="type">DBusServer</span> +to integrate the server with the GLib main loop. +In most cases the context argument should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. +</p> +<p> +If called twice for the same context, does nothing the second +time. If called once with context A and once with context B, +context B replaces context A as the context monitoring the +connection. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>server</code></em> :</span></p></td> +<td>the server</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for default</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-CONNECTION:CAPS"></a><h3>DBUS_TYPE_CONNECTION</h3> +<pre class="programlisting">#define DBUS_TYPE_CONNECTION (dbus_connection_get_g_type ()) +</pre> +<p> +Expands to a function call returning a boxed <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> representing a +<span class="type">DBusConnection</span> pointer from libdbus. Not to be confused with +<a class="link" href="dbus-glib-DBusGConnection.html#DBUS-TYPE-G-CONNECTION:CAPS" title="DBUS_TYPE_G_CONNECTION"><code class="literal">DBUS_TYPE_G_CONNECTION</code></a>, which you should usually use instead. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the GLib type</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-MESSAGE:CAPS"></a><h3>DBUS_TYPE_MESSAGE</h3> +<pre class="programlisting">#define DBUS_TYPE_MESSAGE (dbus_message_get_g_type ()) +</pre> +<p> +Expands to a function call returning a boxed <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> representing a +<span class="type">DBusMessage</span> pointer from libdbus. Not to be confused with +<a class="link" href="dbus-glib-DBusGMessage.html#DBUS-TYPE-G-MESSAGE:CAPS" title="DBUS_TYPE_G_MESSAGE"><code class="literal">DBUS_TYPE_G_MESSAGE</code></a>, which you should usually use instead. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the GLib type</td> +</tr></tbody> +</table></div> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib-DBus-GObject-related-functions.html b/doc/reference/html/dbus-glib-DBus-GObject-related-functions.html new file mode 100644 index 0000000..c4bfa5e --- /dev/null +++ b/doc/reference/html/dbus-glib-DBus-GObject-related-functions.html @@ -0,0 +1,308 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>DBus GObject related functions</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> +<link rel="up" href="ch02.html" title="API Reference"> +<link rel="prev" href="dbus-glib-DBusGConnection.html" title="DBusGConnection"> +<link rel="next" href="dbus-glib-DBusGMessage.html" title="DBusGMessage"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="dbus-glib-DBusGConnection.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> +<td><a accesskey="n" href="dbus-glib-DBusGMessage.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#dbus-glib-DBus-GObject-related-functions.synopsis" class="shortcut">Top</a> +  | + <a href="#dbus-glib-DBus-GObject-related-functions.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="dbus-glib-DBus-GObject-related-functions"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="dbus-glib-DBus-GObject-related-functions.top_of_page"></a>DBus GObject related functions</span></h2> +<p>DBus GObject related functions — Exporting a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> remotely</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="dbus-glib-DBus-GObject-related-functions.stability-level"></a><h2>Stability Level</h2> +Stable, unless otherwise indicated +</div> +<div class="refsynopsisdiv"> +<a name="dbus-glib-DBus-GObject-related-functions.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib.h> + +struct <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo" title="struct DBusGObjectInfo">DBusGObjectInfo</a>; +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-install-info" title="dbus_g_object_type_install_info ()">dbus_g_object_type_install_info</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> object_type</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo" title="struct DBusGObjectInfo"><span class="type">DBusGObjectInfo</span></a> *info</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-register-shadow-property" title="dbus_g_object_type_register_shadow_property ()">dbus_g_object_type_register_shadow_property</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> iface_type</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *dbus_prop_name</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *shadow_prop_name</code></em>); +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-path-get-g-type" title="dbus_g_object_path_get_g_type ()">dbus_g_object_path_get_g_type</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller" title="dbus_g_object_register_marshaller ()">dbus_g_object_register_marshaller</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> marshaller</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> rettype</code></em>, + <em class="parameter"><code>...</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller-array" title="dbus_g_object_register_marshaller_array ()">dbus_g_object_register_marshaller_array</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> marshaller</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> rettype</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_types</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-glib-global-set-disable-legacy-property-access" title="dbus_glib_global_set_disable_legacy_property_access ()">dbus_glib_global_set_disable_legacy_property_access</a> + (<em class="parameter"><code><span class="type">void</span></code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBus-GObject-related-functions.description"></a><h2>Description</h2> +<p> +FIXME +</p> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBus-GObject-related-functions.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="DBusGObjectInfo"></a><h3>struct DBusGObjectInfo</h3> +<pre class="programlisting">struct DBusGObjectInfo { + int format_version; + + const DBusGMethodInfo *method_infos; + int n_method_infos; + const char *data; + const char *exported_signals; + const char *exported_properties; +}; +</pre> +<p> +Introspection data for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>, normally autogenerated by +a tool such as <a class="link" href="dbus-binding-tool.html" title="dbus-binding-tool"><span class="type">dbus-binding-tool</span></a>. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> <em class="structfield"><code><a name="DBusGObjectInfo.format-version"></a>format_version</code></em>;</span></p></td> +<td>Allows us to change the rest of this struct +by adding DBusGObjectInfo2, DBusGObjectInfo3, etc.</td> +</tr> +<tr> +<td><p><span class="term">const <a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInfo" title="struct DBusGMethodInfo"><span class="type">DBusGMethodInfo</span></a> *<em class="structfield"><code><a name="DBusGObjectInfo.method-infos"></a>method_infos</code></em>;</span></p></td> +<td>Array of method pointers</td> +</tr> +<tr> +<td><p><span class="term"><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> <em class="structfield"><code><a name="DBusGObjectInfo.n-method-infos"></a>n_method_infos</code></em>;</span></p></td> +<td>Length of the infos array</td> +</tr> +<tr> +<td><p><span class="term">const <span class="type">char</span> *<em class="structfield"><code><a name="DBusGObjectInfo.data"></a>data</code></em>;</span></p></td> +<td>Introspection data</td> +</tr> +<tr> +<td><p><span class="term">const <span class="type">char</span> *<em class="structfield"><code><a name="DBusGObjectInfo.exported-signals"></a>exported_signals</code></em>;</span></p></td> +<td>Exported signals</td> +</tr> +<tr> +<td><p><span class="term">const <span class="type">char</span> *<em class="structfield"><code><a name="DBusGObjectInfo.exported-properties"></a>exported_properties</code></em>;</span></p></td> +<td>Exported properties</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-object-type-install-info"></a><h3>dbus_g_object_type_install_info ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_object_type_install_info (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> object_type</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo" title="struct DBusGObjectInfo"><span class="type">DBusGObjectInfo</span></a> *info</code></em>);</pre> +<p> +Install introspection information about the given object <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> +sufficient to allow methods on the object to be invoked by name. +The introspection information is normally generated by +dbus-glib-tool, then this function is called in the +<code class="function">class_init()</code> for the object class. +</p> +<p> +Once introspection information has been installed, instances of the +object registered with <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-register-g-object" title="dbus_g_connection_register_g_object ()"><code class="function">dbus_g_connection_register_g_object()</code></a> can have +their methods invoked remotely. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>object_type</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for the object</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td> +<td>introspection data generated by <span class="type">dbus-glib-tool</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-object-type-register-shadow-property"></a><h3>dbus_g_object_type_register_shadow_property ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_object_type_register_shadow_property + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> iface_type</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *dbus_prop_name</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *shadow_prop_name</code></em>);</pre> +<p> +Registers a new property name <em class="parameter"><code>shadow_prop_name</code></em> that overrides the +<em class="parameter"><code>dbus_prop_name</code></em> in D-Bus property get/set requests. Since all properties for +all interfaces implemented by a GObject exist in the same namespace, this +allows implementations to use the same property name in two or more D-Bus +interfaces implemented by the same GObject, as long as one of those D-Bus +interface properties is registered with a shadow property name. +</p> +<p> +For example, if both org.foobar.Baz.InterfaceA and org.foobar.Baz.InterfaceB +have a D-Bus property called "Bork", the developer assigns a shadow property +name to the conflicting property name in one or both of these GInterfaces to +resolve the conflict. Assume the GInterface implementing +org.foobar.Baz.InterfaceA registers a shadow property called "a-bork", while +the GInterface implementing org.foobar.Baz.InterfaceB registers a shadow +property called "b-bork". The GObject implementing both these GInterfaces +would then use #<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-class-override-property"><code class="function">g_object_class_override_property()</code></a> to implement both +"a-bork" and "b-bork" and D-Bus requests for "Bork" on either D-Bus interface +will not conflict. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>iface_type</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for the <span class="type">GInterface</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dbus_prop_name</code></em> :</span></p></td> +<td>D-Bus property name (as specified in the introspection data) +to override with the shadow property name (as specified in the GType's +initialization function, ie glib-style)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>shadow_prop_name</code></em> :</span></p></td> +<td>property name which should override the shadow property</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-object-path-get-g-type"></a><h3>dbus_g_object_path_get_g_type ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_object_path_get_g_type (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +</p> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-object-register-marshaller"></a><h3>dbus_g_object_register_marshaller ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_object_register_marshaller (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> marshaller</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> rettype</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Register a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> to be used for signal invocations, +giving its return type and a list of parameter types, +followed by <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a>. +</p> +<p> +This function will not be needed once GLib includes libffi. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>marshaller</code></em> :</span></p></td> +<td>a GClosureMarshal to be used for invocation</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rettype</code></em> :</span></p></td> +<td>a GType for the return type of the function</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>The parameter <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GTypes</span></a>, followed by <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-object-register-marshaller-array"></a><h3>dbus_g_object_register_marshaller_array ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_object_register_marshaller_array + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> marshaller</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> rettype</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_types</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);</pre> +<p> +Register a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> to be used for signal invocations. +<em class="parameter"><code>see_also</code></em> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller" title="dbus_g_object_register_marshaller ()"><code class="function">dbus_g_object_register_marshaller()</code></a> +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>marshaller</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> to be used for invocation</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rettype</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for the return type of the function</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>n_types</code></em> :</span></p></td> +<td>number of function parameters</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>types</code></em> :</span></p></td> +<td>a C array of GTypes values</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-glib-global-set-disable-legacy-property-access"></a><h3>dbus_glib_global_set_disable_legacy_property_access ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_glib_global_set_disable_legacy_property_access + (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +For historical reasons, DBus-GLib will allow read-only +access to every GObject property of an object exported +to the bus, regardless of whether or not the property +is listed in the type info installed with +<a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-install-info" title="dbus_g_object_type_install_info ()"><code class="function">dbus_g_object_type_install_info()</code></a>. (Write access is +denied however). +</p> +<p> +If you wish to restrict even read-only access, you +can call this method to globally change the behavior +for the entire process. +</p> +<p class="since">Since 0.88</p> +</div> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBus-GObject-related-functions.see-also"></a><h2>See Also</h2> +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib-DBusGConnection.html b/doc/reference/html/dbus-glib-DBusGConnection.html new file mode 100644 index 0000000..f197889 --- /dev/null +++ b/doc/reference/html/dbus-glib-DBusGConnection.html @@ -0,0 +1,388 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>DBusGConnection</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> +<link rel="up" href="ch02.html" title="API Reference"> +<link rel="prev" href="ch02.html" title="API Reference"> +<link rel="next" href="dbus-glib-DBus-GObject-related-functions.html" title="DBus GObject related functions"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="ch02.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> +<td><a accesskey="n" href="dbus-glib-DBus-GObject-related-functions.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#dbus-glib-DBusGConnection.synopsis" class="shortcut">Top</a> +  | + <a href="#dbus-glib-DBusGConnection.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="dbus-glib-DBusGConnection"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="dbus-glib-DBusGConnection.top_of_page"></a>DBusGConnection</span></h2> +<p>DBusGConnection — DBus Connection</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="dbus-glib-DBusGConnection.stability-level"></a><h2>Stability Level</h2> +Stable, unless otherwise indicated +</div> +<div class="refsynopsisdiv"> +<a name="dbus-glib-DBusGConnection.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib.h> + + <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection">DBusGConnection</a>; +#define <a class="link" href="dbus-glib-DBusGConnection.html#DBUS-TYPE-G-CONNECTION:CAPS" title="DBUS_TYPE_G_CONNECTION">DBUS_TYPE_G_CONNECTION</a> +<a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-bus-get" title="dbus_g_bus_get ()">dbus_g_bus_get</a> (<em class="parameter"><code><span class="type">DBusBusType</span> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-bus-get-private" title="dbus_g_bus_get_private ()">dbus_g_bus_get_private</a> (<em class="parameter"><code><span class="type">DBusBusType</span> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-thread-init" title="dbus_g_thread_init ()">dbus_g_thread_init</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-open" title="dbus_g_connection_open ()">dbus_g_connection_open</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *address</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-ref" title="dbus_g_connection_ref ()">dbus_g_connection_ref</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-unref" title="dbus_g_connection_unref ()">dbus_g_connection_unref</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-flush" title="dbus_g_connection_flush ()">dbus_g_connection_flush</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>); +<span class="returnvalue">DBusConnection</span> * <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-get-connection" title="dbus_g_connection_get_connection ()">dbus_g_connection_get_connection</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *gconnection</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-register-g-object" title="dbus_g_connection_register_g_object ()">dbus_g_connection_register_g_object</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *at_path</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-unregister-g-object" title="dbus_g_connection_unregister_g_object ()">dbus_g_connection_unregister_g_object</a> + (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>); +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> * <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-lookup-g-object" title="dbus_g_connection_lookup_g_object ()">dbus_g_connection_lookup_g_object</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *at_path</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGConnection.description"></a><h2>Description</h2> +<p> +A <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> is a boxed type abstracting a DBusConnection. +</p> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGConnection.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="DBusGConnection"></a><h3>DBusGConnection</h3> +<pre class="programlisting">typedef struct _DBusGConnection DBusGConnection;</pre> +<p> +A <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> is a boxed type abstracting a DBusConnection from +libdbus. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-CONNECTION:CAPS"></a><h3>DBUS_TYPE_G_CONNECTION</h3> +<pre class="programlisting">#define DBUS_TYPE_G_CONNECTION (dbus_g_connection_get_g_type ()) +</pre> +<p> +Expands to a function call returning the boxed <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a>. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the GLib type</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-bus-get"></a><h3>dbus_g_bus_get ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * dbus_g_bus_get (<em class="parameter"><code><span class="type">DBusBusType</span> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Returns a connection to the given bus. The connection is a global variable +shared with other callers of this function. +</p> +<p> +(Internally, calls <code class="function">dbus_bus_get()</code> then calls +<a class="link" href="dbus-glib-DBus-GLib-low-level.html#dbus-connection-setup-with-g-main" title="dbus_connection_setup_with_g_main ()"><code class="function">dbus_connection_setup_with_g_main()</code></a> on the result.) +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>bus type</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>address where an error can be returned.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a DBusConnection</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-bus-get-private"></a><h3>dbus_g_bus_get_private ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * dbus_g_bus_get_private (<em class="parameter"><code><span class="type">DBusBusType</span> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Returns a connection to the given bus. The connection will be a private +non-shared connection and should be closed when usage is complete. +</p> +<p> +Internally this function calls <code class="function">dbus_bus_get_private()</code> then calls +<a class="link" href="dbus-glib-DBus-GLib-low-level.html#dbus-connection-setup-with-g-main" title="dbus_connection_setup_with_g_main ()"><code class="function">dbus_connection_setup_with_g_main()</code></a> on the result; see the documentation +of the former function for more information on private connections. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>bus type</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>Mainloop context to attach to</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>address where an error can be returned.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a DBusConnection</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-thread-init"></a><h3>dbus_g_thread_init ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_thread_init (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Initializes the D-BUS thread system. +This function may only be called +once and must be called prior to calling any +other function in the D-BUS API. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-open"></a><h3>dbus_g_connection_open ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * dbus_g_connection_open (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *address</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Returns a connection to the given address. +</p> +<p> +(Internally, calls <code class="function">dbus_connection_open()</code> then calls +<a class="link" href="dbus-glib-DBus-GLib-low-level.html#dbus-connection-setup-with-g-main" title="dbus_connection_setup_with_g_main ()"><code class="function">dbus_connection_setup_with_g_main()</code></a> on the result.) +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td> +<td>address of the connection to open</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>address where an error can be returned.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a DBusConnection</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-ref"></a><h3>dbus_g_connection_ref ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * dbus_g_connection_ref (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>);</pre> +<p> +Increment refcount on a <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> to ref</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the connection that was ref'd</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-unref"></a><h3>dbus_g_connection_unref ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_connection_unref (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>);</pre> +<p> +Decrement refcount on a <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the connection to unref</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-flush"></a><h3>dbus_g_connection_flush ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_connection_flush (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>);</pre> +<p> +Blocks until outgoing calls and signal emissions have been sent. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> to flush</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-get-connection"></a><h3>dbus_g_connection_get_connection ()</h3> +<pre class="programlisting"><span class="returnvalue">DBusConnection</span> * dbus_g_connection_get_connection (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *gconnection</code></em>);</pre> +<p> +Get the <span class="type">DBusConnection</span> corresponding to this <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a>. +The return value does not have its refcount incremented. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>gconnection</code></em> :</span></p></td> +<td>a <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td><span class="type">DBusConnection</span></td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-register-g-object"></a><h3>dbus_g_connection_register_g_object ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_connection_register_g_object (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *at_path</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>);</pre> +<p> +Registers a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> at the given path. Properties, methods, and signals +of the object can then be accessed remotely. Methods are only available +if method introspection data has been added to the object's class +with <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-install-info" title="dbus_g_object_type_install_info ()"><code class="function">dbus_g_object_type_install_info()</code></a>. +</p> +<p> +The registration will be cancelled if either the <span class="type">DBusConnection</span> or +the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> gets finalized, or if <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-unregister-g-object" title="dbus_g_connection_unregister_g_object ()"><code class="function">dbus_g_connection_unregister_g_object()</code></a> +is used. +</p> +<p> +Note: If an object is registered multiple times, the first registration +takes priority for cases such as turning an object into an object path. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the D-BUS connection</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>at_path</code></em> :</span></p></td> +<td>the path where the object will live (the object's name)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td> +<td>the object</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-unregister-g-object"></a><h3>dbus_g_connection_unregister_g_object ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_connection_unregister_g_object + (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>);</pre> +<p> +Removes <em class="parameter"><code>object</code></em> from any object paths at which it is exported on +<em class="parameter"><code>connection</code></em>. Properties, methods, and signals +of the object can no longer be accessed remotely. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the D-BUS connection</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td> +<td>the object</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-connection-lookup-g-object"></a><h3>dbus_g_connection_lookup_g_object ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> * dbus_g_connection_lookup_g_object (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *at_path</code></em>);</pre> +<p> +FIXME +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>a <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>at_path</code></em> :</span></p></td> +<td>path</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the object at path <em class="parameter"><code>at_path</code></em> +</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGConnection.see-also"></a><h2>See Also</h2> +<span class="type">DBusConnection</span> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib-DBusGError.html b/doc/reference/html/dbus-glib-DBusGError.html new file mode 100644 index 0000000..6efed6f --- /dev/null +++ b/doc/reference/html/dbus-glib-DBusGError.html @@ -0,0 +1,239 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>DBusGError</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> +<link rel="up" href="ch02.html" title="API Reference"> +<link rel="prev" href="dbus-glib-DBusGMethod.html" title="DBusGMethod"> +<link rel="next" href="dbus-glib-DBusGProxy.html" title="DBusGProxy"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="dbus-glib-DBusGMethod.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> +<td><a accesskey="n" href="dbus-glib-DBusGProxy.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#dbus-glib-DBusGError.synopsis" class="shortcut">Top</a> +  | + <a href="#dbus-glib-DBusGError.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="dbus-glib-DBusGError"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="dbus-glib-DBusGError.top_of_page"></a>DBusGError</span></h2> +<p>DBusGError — DBus GError</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="dbus-glib-DBusGError.stability-level"></a><h2>Stability Level</h2> +Stable, unless otherwise indicated +</div> +<div class="refsynopsisdiv"> +<a name="dbus-glib-DBusGError.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib.h> + +enum <a class="link" href="dbus-glib-DBusGError.html#DBusGError" title="enum DBusGError">DBusGError</a>; +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-DBusGError.html#dbus-g-error-has-name" title="dbus_g_error_has_name ()">dbus_g_error_has_name</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *name</code></em>); +const <span class="returnvalue">char</span> * <a class="link" href="dbus-glib-DBusGError.html#dbus-g-error-get-name" title="dbus_g_error_get_name ()">dbus_g_error_get_name</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGError.html#dbus-g-error-domain-register" title="dbus_g_error_domain_register ()">dbus_g_error_domain_register</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> domain</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *default_iface</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> code_enum</code></em>); +#define <a class="link" href="dbus-glib-DBusGError.html#DBUS-GERROR:CAPS" title="DBUS_GERROR">DBUS_GERROR</a> +</pre> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGError.description"></a><h2>Description</h2> +<p> +<a class="link" href="dbus-glib-DBusGError.html#DBusGError" title="enum DBusGError"><span class="type">DBusGError</span></a> is the <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> used by DBus. +</p> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGError.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="DBusGError"></a><h3>enum DBusGError</h3> +<pre class="programlisting">typedef enum { +DBUS_GERROR_FAILED, +DBUS_GERROR_NO_MEMORY, +DBUS_GERROR_SERVICE_UNKNOWN, +DBUS_GERROR_NAME_HAS_NO_OWNER, +DBUS_GERROR_NO_REPLY, +DBUS_GERROR_IO_ERROR, +DBUS_GERROR_BAD_ADDRESS, +DBUS_GERROR_NOT_SUPPORTED, +DBUS_GERROR_LIMITS_EXCEEDED, +DBUS_GERROR_ACCESS_DENIED, +DBUS_GERROR_AUTH_FAILED, +DBUS_GERROR_NO_SERVER, +DBUS_GERROR_TIMEOUT, +DBUS_GERROR_NO_NETWORK, +DBUS_GERROR_ADDRESS_IN_USE, +DBUS_GERROR_DISCONNECTED, +DBUS_GERROR_INVALID_ARGS, +DBUS_GERROR_FILE_NOT_FOUND, +DBUS_GERROR_FILE_EXISTS, +DBUS_GERROR_UNKNOWN_METHOD, +DBUS_GERROR_TIMED_OUT, +DBUS_GERROR_MATCH_RULE_NOT_FOUND, +DBUS_GERROR_MATCH_RULE_INVALID, +DBUS_GERROR_SPAWN_EXEC_FAILED, +DBUS_GERROR_SPAWN_FORK_FAILED, +DBUS_GERROR_SPAWN_CHILD_EXITED, +DBUS_GERROR_SPAWN_CHILD_SIGNALED, +DBUS_GERROR_SPAWN_FAILED, +DBUS_GERROR_UNIX_PROCESS_ID_UNKNOWN, +DBUS_GERROR_INVALID_SIGNATURE, +DBUS_GERROR_INVALID_FILE_CONTENT, +DBUS_GERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN, +DBUS_GERROR_REMOTE_EXCEPTION +} DBusGError; +</pre> +<p> +A <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> enumeration for the domain <a class="link" href="dbus-glib-DBusGError.html#DBUS-GERROR:CAPS" title="DBUS_GERROR"><code class="literal">DBUS_GERROR</code></a>. The values' meanings +can be found by looking at the comments for the corresponding constants +in dbus-protocol.h. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-error-has-name"></a><h3>dbus_g_error_has_name ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_error_has_name (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre> +<p> +Determine whether D-BUS error name for a remote exception matches +the given name. This function is intended to be invoked on a +<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> returned from an invocation of a remote method, e.g. via +<a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()"><code class="function">dbus_g_proxy_end_call()</code></a>. It will silently return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for errors +which are not remote D-BUS exceptions (i.e. with a domain other +than <a class="link" href="dbus-glib-DBusGError.html#DBUS-GERROR:CAPS" title="DBUS_GERROR"><code class="literal">DBUS_GERROR</code></a> or a code other than +<code class="literal">DBUS_GERROR_REMOTE_EXCEPTION</code>). +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>the GError given from the remote method</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> +<td>the D-BUS error name</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if and only if the remote error has the given name</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-error-get-name"></a><h3>dbus_g_error_get_name ()</h3> +<pre class="programlisting">const <span class="returnvalue">char</span> * dbus_g_error_get_name (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);</pre> +<p> +This function may only be invoked on a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> returned from an +invocation of a remote method, e.g. via <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()"><code class="function">dbus_g_proxy_end_call()</code></a>. +Moreover, you must ensure that the error's domain is <a class="link" href="dbus-glib-DBusGError.html#DBUS-GERROR:CAPS" title="DBUS_GERROR"><code class="literal">DBUS_GERROR</code></a>, +and the code is <code class="literal">DBUS_GERROR_REMOTE_EXCEPTION</code>. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> given from the remote method</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the D-BUS name for a remote exception.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-error-domain-register"></a><h3>dbus_g_error_domain_register ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_error_domain_register (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> domain</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *default_iface</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> code_enum</code></em>);</pre> +<p> +Register a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> domain and set of codes with D-Bus. When an object +raises a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> in the domain <em class="parameter"><code>domain</code></em> from one of its D-Bus methods, +the D-Bus error name used will be <em class="parameter"><code>default_iface</code></em>, followed by a dot, +followed by the <span class="type">GEnumValue.value_nick</span> corresponding to the <span class="type">GError.code</span>. +For D-Bus, it's conventional to use an error name (value_nick) that is +in CamelCase. +</p> +<p> +(For instance, if a D-Bus method <code class="code">com.example.MyObject.GetThings</code> +can raise a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> with domain <code class="code">MY_ERROR</code> and code +<code class="code">MY_ERROR_NOT_HAPPY</code>, you could call +<code class="code">dbus_g_error_domain_register (MY_ERROR, "com.example.MyError", +MY_TYPE_ERROR)</code>, and set up the value_nick for +<code class="code">MY_ERROR_NOT_HAPPY</code> to be <code class="code">NotHappy</code>, +resulting in the D-Bus error string +<code class="code">com.example.MyError.NotHappy</code>.) +</p> +<p> +If <em class="parameter"><code>default_iface</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the D-Bus interface of the method that failed +will be used. +</p> +<p> +(For instance, if the above example had called +<code class="code">dbus_g_error_domain_register (MY_ERROR, NULL, MY_TYPE_ERROR)</code> +instead, then the D-Bus error string would be +<code class="code">com.example.MyObject.NotHappy</code>.) +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td> +<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> domain</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>default_iface</code></em> :</span></p></td> +<td>the prefix used for error values, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>code_enum</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a <span class="type">GEnum</span> of the error codes</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-GERROR:CAPS"></a><h3>DBUS_GERROR</h3> +<pre class="programlisting">#define DBUS_GERROR dbus_g_error_quark () +</pre> +<p> +Expands to a function call returning the error domain quark for <a class="link" href="dbus-glib-DBusGError.html#DBusGError" title="enum DBusGError"><span class="type">DBusGError</span></a>, +for use with <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>. +</p> +</div> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGError.see-also"></a><h2>See Also</h2> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib-DBusGMessage.html b/doc/reference/html/dbus-glib-DBusGMessage.html new file mode 100644 index 0000000..0c17dd7 --- /dev/null +++ b/doc/reference/html/dbus-glib-DBusGMessage.html @@ -0,0 +1,155 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>DBusGMessage</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> +<link rel="up" href="ch02.html" title="API Reference"> +<link rel="prev" href="dbus-glib-DBus-GObject-related-functions.html" title="DBus GObject related functions"> +<link rel="next" href="dbus-glib-DBusGMethod.html" title="DBusGMethod"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="dbus-glib-DBus-GObject-related-functions.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> +<td><a accesskey="n" href="dbus-glib-DBusGMethod.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#dbus-glib-DBusGMessage.synopsis" class="shortcut">Top</a> +  | + <a href="#dbus-glib-DBusGMessage.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="dbus-glib-DBusGMessage"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="dbus-glib-DBusGMessage.top_of_page"></a>DBusGMessage</span></h2> +<p>DBusGMessage — DBus Message</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMessage.stability-level"></a><h2>Stability Level</h2> +Stable, unless otherwise indicated +</div> +<div class="refsynopsisdiv"> +<a name="dbus-glib-DBusGMessage.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib.h> + + <a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage">DBusGMessage</a>; +#define <a class="link" href="dbus-glib-DBusGMessage.html#DBUS-TYPE-G-MESSAGE:CAPS" title="DBUS_TYPE_G_MESSAGE">DBUS_TYPE_G_MESSAGE</a> +<a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="returnvalue">DBusGMessage</span></a> * <a class="link" href="dbus-glib-DBusGMessage.html#dbus-g-message-ref" title="dbus_g_message_ref ()">dbus_g_message_ref</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> *message</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGMessage.html#dbus-g-message-unref" title="dbus_g_message_unref ()">dbus_g_message_unref</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> *message</code></em>); +<span class="returnvalue">DBusMessage</span> * <a class="link" href="dbus-glib-DBusGMessage.html#dbus-g-message-get-message" title="dbus_g_message_get_message ()">dbus_g_message_get_message</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> *gmessage</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMessage.description"></a><h2>Description</h2> +<p> +A <a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> is a boxed type abstracting a DBusMessage. +</p> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMessage.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="DBusGMessage"></a><h3>DBusGMessage</h3> +<pre class="programlisting">typedef struct _DBusGMessage DBusGMessage;</pre> +<p> +A <a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> is a boxed type abstracting a DBusMessage from +libdbus. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-MESSAGE:CAPS"></a><h3>DBUS_TYPE_G_MESSAGE</h3> +<pre class="programlisting">#define DBUS_TYPE_G_MESSAGE (dbus_g_message_get_g_type ()) +</pre> +<p> +Expands to a function call returning the boxed <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a>. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the GLib type</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-message-ref"></a><h3>dbus_g_message_ref ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="returnvalue">DBusGMessage</span></a> * dbus_g_message_ref (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> *message</code></em>);</pre> +<p> +Increment refcount on a <a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td> +<td>the message to ref</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the message that was ref'd</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-message-unref"></a><h3>dbus_g_message_unref ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_message_unref (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> *message</code></em>);</pre> +<p> +Decrement refcount on a <a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td> +<td>the message to unref</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-message-get-message"></a><h3>dbus_g_message_get_message ()</h3> +<pre class="programlisting"><span class="returnvalue">DBusMessage</span> * dbus_g_message_get_message (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> *gmessage</code></em>);</pre> +<p> +Get the <span class="type">DBusMessage</span> corresponding to this <a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a>. +The return value does not have its refcount incremented. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>gmessage</code></em> :</span></p></td> +<td>a <a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td><span class="type">DBusMessage</span></td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMessage.see-also"></a><h2>See Also</h2> +<span class="type">DBusMessage</span> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib-DBusGMethod.html b/doc/reference/html/dbus-glib-DBusGMethod.html new file mode 100644 index 0000000..7b0d88e --- /dev/null +++ b/doc/reference/html/dbus-glib-DBusGMethod.html @@ -0,0 +1,239 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>DBusGMethod</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> +<link rel="up" href="ch02.html" title="API Reference"> +<link rel="prev" href="dbus-glib-DBusGMessage.html" title="DBusGMessage"> +<link rel="next" href="dbus-glib-DBusGError.html" title="DBusGError"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="dbus-glib-DBusGMessage.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> +<td><a accesskey="n" href="dbus-glib-DBusGError.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#dbus-glib-DBusGMethod.synopsis" class="shortcut">Top</a> +  | + <a href="#dbus-glib-DBusGMethod.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="dbus-glib-DBusGMethod"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="dbus-glib-DBusGMethod.top_of_page"></a>DBusGMethod</span></h2> +<p>DBusGMethod — GMethod Info & Invocation</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMethod.stability-level"></a><h2>Stability Level</h2> +Stable, unless otherwise indicated +</div> +<div class="refsynopsisdiv"> +<a name="dbus-glib-DBusGMethod.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib.h> + +struct <a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInfo" title="struct DBusGMethodInfo">DBusGMethodInfo</a>; + <a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation">DBusGMethodInvocation</a>; +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="dbus-glib-DBusGMethod.html#dbus-g-method-get-sender" title="dbus_g_method_get_sender ()">dbus_g_method_get_sender</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>); +<span class="returnvalue">DBusMessage</span> * <a class="link" href="dbus-glib-DBusGMethod.html#dbus-g-method-get-reply" title="dbus_g_method_get_reply ()">dbus_g_method_get_reply</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGMethod.html#dbus-g-method-send-reply" title="dbus_g_method_send_reply ()">dbus_g_method_send_reply</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, + <em class="parameter"><code><span class="type">DBusMessage</span> *reply</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGMethod.html#dbus-g-method-return" title="dbus_g_method_return ()">dbus_g_method_return</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, + <em class="parameter"><code>...</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGMethod.html#dbus-g-method-return-error" title="dbus_g_method_return_error ()">dbus_g_method_return_error</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMethod.description"></a><h2>Description</h2> +<p> +These types are used to call methods on <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> objects. +</p> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMethod.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="DBusGMethodInfo"></a><h3>struct DBusGMethodInfo</h3> +<pre class="programlisting">struct DBusGMethodInfo { + GCallback function; + GClosureMarshal marshaller; + int data_offset; +}; +</pre> +<p> +Object typically generated by <a class="link" href="dbus-binding-tool.html" title="dbus-binding-tool"><span class="type">dbus-binding-tool</span></a> that +stores a mapping from introspection data to a +function pointer for a C method to be invoked. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> <em class="structfield"><code><a name="DBusGMethodInfo.function"></a>function</code></em>;</span></p></td> +<td>C method to invoke</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"><span class="type">GClosureMarshal</span></a> <em class="structfield"><code><a name="DBusGMethodInfo.marshaller"></a>marshaller</code></em>;</span></p></td> +<td>Marshaller to invoke method</td> +</tr> +<tr> +<td><p><span class="term"><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> <em class="structfield"><code><a name="DBusGMethodInfo.data-offset"></a>data_offset</code></em>;</span></p></td> +<td>Offset into the introspection data</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="DBusGMethodInvocation"></a><h3>DBusGMethodInvocation</h3> +<pre class="programlisting">typedef struct _DBusGMethodInvocation DBusGMethodInvocation;</pre> +<p> +The context of an asynchronous method call. See <a class="link" href="dbus-glib-DBusGMethod.html#dbus-g-method-return" title="dbus_g_method_return ()"><code class="function">dbus_g_method_return()</code></a> and +<a class="link" href="dbus-glib-DBusGMethod.html#dbus-g-method-return-error" title="dbus_g_method_return_error ()"><code class="function">dbus_g_method_return_error()</code></a>. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-method-get-sender"></a><h3>dbus_g_method_get_sender ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * dbus_g_method_get_sender (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre> +<p> +Get the sender of a message so we can send a +"reply" later (i.e. send a message directly +to a service which invoked the method at a +later time). +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>the method context</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the unique name of the sender. It +is up to the caller to free the returned string.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-method-get-reply"></a><h3>dbus_g_method_get_reply ()</h3> +<pre class="programlisting"><span class="returnvalue">DBusMessage</span> * dbus_g_method_get_reply (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre> +<p> +Get the reply message to append reply values +Used as a sidedoor when you can't generate dbus values +of the correct type due to glib binding limitations +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>the method context</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a <span class="type">DBusMessage</span> with the reply</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-method-send-reply"></a><h3>dbus_g_method_send_reply ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_method_send_reply (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, + <em class="parameter"><code><span class="type">DBusMessage</span> *reply</code></em>);</pre> +<p> +Send a manually created reply message. +</p> +<p> +Used as a sidedoor when you can't generate dbus values +of the correct type due to glib binding limitations +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>the method context</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>reply</code></em> :</span></p></td> +<td>the reply message, will be unreffed</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-method-return"></a><h3>dbus_g_method_return ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_method_return (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Send a return message for a given method invocation, with arguments. +This function also frees the sending context. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>the method context</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>zero or more values to return from the method, with their number +and types given by its <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo" title="struct DBusGObjectInfo"><span class="type">DBusGObjectInfo</span></a> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-method-return-error"></a><h3>dbus_g_method_return_error ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_method_return_error (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGMethod.html#DBusGMethodInvocation" title="DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);</pre> +<p> +Send a error message for a given method invocation. +This function also frees the sending context. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> +<td>the method context</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>the error to send</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGMethod.see-also"></a><h2>See Also</h2> +<a class="link" href="dbus-glib-DBusGMessage.html#DBusGMessage" title="DBusGMessage"><span class="type">DBusGMessage</span></a> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib-DBusGProxy.html b/doc/reference/html/dbus-glib-DBusGProxy.html new file mode 100644 index 0000000..f94ea10 --- /dev/null +++ b/doc/reference/html/dbus-glib-DBusGProxy.html @@ -0,0 +1,1069 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>DBusGProxy</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> +<link rel="up" href="ch02.html" title="API Reference"> +<link rel="prev" href="dbus-glib-DBusGError.html" title="DBusGError"> +<link rel="next" href="dbus-glib-Specializable-GType-System.html" title="Specializable GType System"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="dbus-glib-DBusGError.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> +<td><a accesskey="n" href="dbus-glib-Specializable-GType-System.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#dbus-glib-DBusGProxy.synopsis" class="shortcut">Top</a> +  | + <a href="#dbus-glib-DBusGProxy.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="dbus-glib-DBusGProxy"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="dbus-glib-DBusGProxy.top_of_page"></a>DBusGProxy</span></h2> +<p>DBusGProxy — DBus Proxy</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="dbus-glib-DBusGProxy.stability-level"></a><h2>Stability Level</h2> +Stable, unless otherwise indicated +</div> +<div class="refsynopsisdiv"> +<a name="dbus-glib-DBusGProxy.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib.h> + +struct <a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy">DBusGProxy</a>; + <a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall">DBusGProxyCall</a>; +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCallNotify" title="DBusGProxyCallNotify ()">*DBusGProxyCallNotify</a>) (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="type">DBusGProxyCall</span></a> *call_id</code></em>, + <em class="parameter"><code><span class="type">void</span> *user_data</code></em>); +<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name" title="dbus_g_proxy_new_for_name ()">dbus_g_proxy_new_for_name</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>); +<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()">dbus_g_proxy_new_for_name_owner</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-from-proxy" title="dbus_g_proxy_new_from_proxy ()">dbus_g_proxy_new_from_proxy</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>); +<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-peer" title="dbus_g_proxy_new_for_peer ()">dbus_g_proxy_new_for_peer</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-set-interface" title="dbus_g_proxy_set_interface ()">dbus_g_proxy_set_interface</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *interface_name</code></em>); +const <span class="returnvalue">char</span> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-get-path" title="dbus_g_proxy_get_path ()">dbus_g_proxy_get_path</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>); +const <span class="returnvalue">char</span> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-get-bus-name" title="dbus_g_proxy_get_bus_name ()">dbus_g_proxy_get_bus_name</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>); +const <span class="returnvalue">char</span> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-get-interface" title="dbus_g_proxy_get_interface ()">dbus_g_proxy_get_interface</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-add-signal" title="dbus_g_proxy_add_signal ()">dbus_g_proxy_add_signal</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *signal_name</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_type</code></em>, + <em class="parameter"><code>...</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-connect-signal" title="dbus_g_proxy_connect_signal ()">dbus_g_proxy_connect_signal</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *signal_name</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> handler</code></em>, + <em class="parameter"><code><span class="type">void</span> *data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureNotify"><span class="type">GClosureNotify</span></a> free_data_func</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-disconnect-signal" title="dbus_g_proxy_disconnect_signal ()">dbus_g_proxy_disconnect_signal</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *signal_name</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> handler</code></em>, + <em class="parameter"><code><span class="type">void</span> *data</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-send" title="dbus_g_proxy_send ()">dbus_g_proxy_send</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><span class="type">DBusMessage</span> *message</code></em>, + <em class="parameter"><code><span class="type">dbus_uint32_t</span> *client_serial</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-call" title="dbus_g_proxy_call ()">dbus_g_proxy_call</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-call-with-timeout" title="dbus_g_proxy_call_with_timeout ()">dbus_g_proxy_call_with_timeout</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> timeout</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-call-no-reply" title="dbus_g_proxy_call_no_reply ()">dbus_g_proxy_call_no_reply</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>); +<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="returnvalue">DBusGProxyCall</span></a> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()">dbus_g_proxy_begin_call</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCallNotify" title="DBusGProxyCallNotify ()"><span class="type">DBusGProxyCallNotify</span></a> notify</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>); +<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="returnvalue">DBusGProxyCall</span></a> * <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call-with-timeout" title="dbus_g_proxy_begin_call_with_timeout ()">dbus_g_proxy_begin_call_with_timeout</a> + (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCallNotify" title="DBusGProxyCallNotify ()"><span class="type">DBusGProxyCallNotify</span></a> notify</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>, + <em class="parameter"><code><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> timeout</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()">dbus_g_proxy_end_call</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="type">DBusGProxyCall</span></a> *call</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-cancel-call" title="dbus_g_proxy_cancel_call ()">dbus_g_proxy_cancel_call</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="type">DBusGProxyCall</span></a> *call</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-set-default-timeout" title="dbus_g_proxy_set_default_timeout ()">dbus_g_proxy_set_default_timeout</a> (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> timeout</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGProxy.description"></a><h2>Description</h2> +<p> +A <a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> is a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> representing a remote object in a D-Bus +service. +</p> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGProxy.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="DBusGProxy"></a><h3>struct DBusGProxy</h3> +<pre class="programlisting">struct DBusGProxy { +}; +</pre> +<p> +A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> representing a remote object in a D-Bus service. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBusGProxyCall"></a><h3>DBusGProxyCall</h3> +<pre class="programlisting">typedef struct _DBusGProxyCall DBusGProxyCall;</pre> +<p> +An opaque pointer representing an asynchronous call in progress. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBusGProxyCallNotify"></a><h3>DBusGProxyCallNotify ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGProxyCallNotify) (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="type">DBusGProxyCall</span></a> *call_id</code></em>, + <em class="parameter"><code><span class="type">void</span> *user_data</code></em>);</pre> +<p> +Called when a reply to the call represented by <em class="parameter"><code>call_id</code></em> arrives. +Use <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()"><code class="function">dbus_g_proxy_end_call()</code></a> to see whether <em class="parameter"><code>call_id</code></em> succeeded or +failed, and get the arguments returned (if any) on success. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>the proxy on which the method was called</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>call_id</code></em> :</span></p></td> +<td>the call in progress</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>data passed to <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()"><code class="function">dbus_g_proxy_begin_call()</code></a> or similar</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-new-for-name"></a><h3>dbus_g_proxy_new_for_name ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * dbus_g_proxy_new_for_name (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>);</pre> +<p> +Creates a new proxy for a remote interface exported by a connection +on a message bus. Method calls and signal connections over this +proxy will go to the name owner; the name's owner is expected to +support the given interface name. THE NAME OWNER MAY CHANGE OVER +TIME, for example between two different method calls, unless the +name is a unique name. If you need a fixed owner, you need to +request the current owner and bind a proxy to its unique name +rather than to the generic name; see +<a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()"><code class="function">dbus_g_proxy_new_for_name_owner()</code></a>. +</p> +<p> +A name-associated proxy only makes sense with a message bus, not +for app-to-app direct dbus connections. +</p> +<p> +This proxy will only emit the "destroy" signal if the +<span class="type">DBusConnection</span> is disconnected, the proxy has no remaining +references, or the name is a unique name and its owner +disappears. If a well-known name changes owner, the proxy will +still be alive. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the connection to the remote bus</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> +<td>any name on the message bus</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> +<td>name of the object instance to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>iface</code></em> :</span></p></td> +<td>name of the interface to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>new proxy object</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-new-for-name-owner"></a><h3>dbus_g_proxy_new_for_name_owner ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * dbus_g_proxy_new_for_name_owner (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Similar to <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name" title="dbus_g_proxy_new_for_name ()"><code class="function">dbus_g_proxy_new_for_name()</code></a>, but makes a round-trip +request to the message bus to get the current name owner, then +binds the proxy to the unique name of the current owner, rather +than to the well-known name. As a result, the name owner will +not change over time, and the proxy will emit the "destroy" signal +when the owner disappears from the message bus. +</p> +<p> +An example of the difference between <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name" title="dbus_g_proxy_new_for_name ()"><code class="function">dbus_g_proxy_new_for_name()</code></a> +and <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()"><code class="function">dbus_g_proxy_new_for_name_owner()</code></a>: if you provide the well-known name +"org.freedesktop.Database" <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name" title="dbus_g_proxy_new_for_name ()"><code class="function">dbus_g_proxy_new_for_name()</code></a> remains bound +to that name as it changes owner. <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()"><code class="function">dbus_g_proxy_new_for_name_owner()</code></a> +will fail if the name has no owner. If the name has an owner, +<a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()"><code class="function">dbus_g_proxy_new_for_name_owner()</code></a> will bind to the unique name +of that owner rather than the generic name. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the connection to the remote bus</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> +<td>any name on the message bus</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> +<td>name of the object inside the service to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>iface</code></em> :</span></p></td> +<td>name of the interface to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>new proxy object, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-new-from-proxy"></a><h3>dbus_g_proxy_new_from_proxy ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * dbus_g_proxy_new_from_proxy (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>);</pre> +<p> +Creates a proxy using an existing proxy as a template, substituting +the specified interface and path. Either or both may be NULL. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>the proxy to use as a template</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>iface</code></em> :</span></p></td> +<td>name of the interface to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> +<td>of the object inside the peer to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>new proxy object</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-new-for-peer"></a><h3>dbus_g_proxy_new_for_peer ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="returnvalue">DBusGProxy</span></a> * dbus_g_proxy_new_for_peer (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGConnection.html#DBusGConnection" title="DBusGConnection"><span class="type">DBusGConnection</span></a> *connection</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *path</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>);</pre> +<p> +Creates a proxy for an object in peer application (one +we're directly connected to). That is, this function is +intended for use when there's no message bus involved, +we're doing a simple 1-to-1 communication between two +applications. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> +<td>the connection to the peer</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td> +<td>name of the object inside the peer to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>iface</code></em> :</span></p></td> +<td>name of the interface to call methods on</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>new proxy object</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-set-interface"></a><h3>dbus_g_proxy_set_interface ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_set_interface (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *interface_name</code></em>);</pre> +<p> +Sets the object interface proxy is bound to +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>the proxy</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>interface_name</code></em> :</span></p></td> +<td>an object interface</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-get-path"></a><h3>dbus_g_proxy_get_path ()</h3> +<pre class="programlisting">const <span class="returnvalue">char</span> * dbus_g_proxy_get_path (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>);</pre> +<p> +Gets the path this proxy is bound to +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>the proxy</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>an object path</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-get-bus-name"></a><h3>dbus_g_proxy_get_bus_name ()</h3> +<pre class="programlisting">const <span class="returnvalue">char</span> * dbus_g_proxy_get_bus_name (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>);</pre> +<p> +Gets the bus name a proxy is bound to (may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in some cases). +If you created the proxy with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name" title="dbus_g_proxy_new_for_name ()"><code class="function">dbus_g_proxy_new_for_name()</code></a>, then +the name you passed to that will be returned. +If you created it with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()"><code class="function">dbus_g_proxy_new_for_name_owner()</code></a>, then the +unique connection name will be returned. If you created it +with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-peer" title="dbus_g_proxy_new_for_peer ()"><code class="function">dbus_g_proxy_new_for_peer()</code></a> then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>the proxy</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the bus name the proxy sends messages to</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-get-interface"></a><h3>dbus_g_proxy_get_interface ()</h3> +<pre class="programlisting">const <span class="returnvalue">char</span> * dbus_g_proxy_get_interface (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>);</pre> +<p> +Gets the object interface proxy is bound to (may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in some cases). +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>the proxy</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>an object interface</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-add-signal"></a><h3>dbus_g_proxy_add_signal ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_add_signal (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *signal_name</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Specifies the argument signature of a D-Bus signal. When the signal is +emitted by the remote object, if the GTypes corresponding to its arguments' +types do not match the types given here, the signal will be ignored. +</p> +<p> +It is an error to add the same <em class="parameter"><code>signal_name</code></em> to the same <em class="parameter"><code>proxy</code></em> more than +once, even if the argument types given are the same. +</p> +<p> +It is also an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>the proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td> +<td>the name of the signal</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>first_type</code></em> :</span></p></td> +<td>the first argument type, or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> if none</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>any subsequent argument types, followed by <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-connect-signal"></a><h3>dbus_g_proxy_connect_signal ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_connect_signal (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *signal_name</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> handler</code></em>, + <em class="parameter"><code><span class="type">void</span> *data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureNotify"><span class="type">GClosureNotify</span></a> free_data_func</code></em>);</pre> +<p> +Connect a signal handler to a proxy for a remote interface. When +the remote interface emits the specified signal, the proxy will +emit a corresponding GLib signal. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td> +<td>the DBus signal name to listen for</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td> +<td>the handler to connect</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> +<td>data to pass to handler</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>free_data_func</code></em> :</span></p></td> +<td>callback function to destroy data</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-disconnect-signal"></a><h3>dbus_g_proxy_disconnect_signal ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_disconnect_signal (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *signal_name</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> handler</code></em>, + <em class="parameter"><code><span class="type">void</span> *data</code></em>);</pre> +<p> +Disconnect all signal handlers from a proxy that match the given +criteria. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td> +<td>the DBus signal name to disconnect</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td> +<td>the handler to disconnect</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> +<td>the data that was registered with handler</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-send"></a><h3>dbus_g_proxy_send ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_send (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><span class="type">DBusMessage</span> *message</code></em>, + <em class="parameter"><code><span class="type">dbus_uint32_t</span> *client_serial</code></em>);</pre> +<p> +Sends a message to the interface we're proxying for. Does not +block or wait for a reply. The message is only actually written out +when you return to the main loop or block in +<a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-flush" title="dbus_g_connection_flush ()"><code class="function">dbus_g_connection_flush()</code></a>. +</p> +<p> +The message is modified to be addressed to the target interface. +That is, a destination name field or whatever is needed will be +added to the message. The basic point of this function is to add +the necessary header fields, otherwise it's equivalent to +<code class="function">dbus_connection_send()</code>. +</p> +<p> +This function adds a reference to the message, so the caller +still owns its original reference. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td> +<td>the message to address and send</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>client_serial</code></em> :</span></p></td> +<td>return location for message's serial, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-call"></a><h3>dbus_g_proxy_call ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_proxy_call (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Function for synchronously invoking a method and receiving reply +values. This function is equivalent to dbus_g_proxy_begin_call +followed by dbus_g_proxy_end_call. All of the input arguments are +specified first, followed by G_TYPE_INVALID, followed by all of the +output values, followed by a second G_TYPE_INVALID. Note that +this means you must always specify G_TYPE_INVALID twice. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td> +<td>method to invoke</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td> +<td>type of first "in" argument, or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> if none</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>value of first "in" argument, any further type/value pairs, +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a>, type/location pairs for "out" arguments, +and <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> again</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the method succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it fails</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-call-with-timeout"></a><h3>dbus_g_proxy_call_with_timeout ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_proxy_call_with_timeout (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> timeout</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Function for synchronously invoking a method and receiving reply +values. This function is equivalent to dbus_g_proxy_begin_call +followed by dbus_g_proxy_end_call. All of the input arguments are +specified first, followed by G_TYPE_INVALID, followed by all of the +output values, followed by a second G_TYPE_INVALID. Note that +this means you must always specify G_TYPE_INVALID twice. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td> +<td>method to invoke</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td> +<td>the timeout in milliseconds, or -1 to use a default</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td> +<td>type of first "in" argument</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>as for <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-call" title="dbus_g_proxy_call ()"><code class="function">dbus_g_proxy_call()</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the method succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it fails</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-call-no-reply"></a><h3>dbus_g_proxy_call_no_reply ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_call_no_reply (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Sends a method call message as with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()"><code class="function">dbus_g_proxy_begin_call()</code></a>, but +does not ask for a reply or allow you to receive one. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<p> +TODO: this particular function shouldn't die on out of memory, +since you should be able to do a call with large arguments. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td> +<td>the name of the method to invoke</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td> +<td>type of the first argument, or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> to call +the method without arguments</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>the first argument and any remaining type/argument pairs, followed by +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> to terminate the list</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-begin-call"></a><h3>dbus_g_proxy_begin_call ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="returnvalue">DBusGProxyCall</span></a> * dbus_g_proxy_begin_call (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCallNotify" title="DBusGProxyCallNotify ()"><span class="type">DBusGProxyCallNotify</span></a> notify</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Asynchronously invokes a method on a remote interface. The method +call will not be sent over the wire until the application returns +to the main loop, or blocks in <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-flush" title="dbus_g_connection_flush ()"><code class="function">dbus_g_connection_flush()</code></a> to write out +pending data. The call will be completed after a timeout, or when +a reply is received. When the call returns, the callback specified +will be invoked; you can then collect the results of the call +(which may be an error, or a reply), use <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()"><code class="function">dbus_g_proxy_end_call()</code></a>. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<p> +TODO this particular function shouldn't die on out of memory, +since you should be able to do a call with large arguments. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td> +<td>the name of the method to invoke</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td> +<td>callback to be invoked when method returns</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data passed to callback</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td> +<td>function called to destroy user_data</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td> +<td>type of the first argument, or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> if there +are no arguments</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>first argument, followed by any further type/value pairs, followed +by <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>call identifier.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-begin-call-with-timeout"></a><h3>dbus_g_proxy_begin_call_with_timeout ()</h3> +<pre class="programlisting"><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="returnvalue">DBusGProxyCall</span></a> * dbus_g_proxy_begin_call_with_timeout + (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *method</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCallNotify" title="DBusGProxyCallNotify ()"><span class="type">DBusGProxyCallNotify</span></a> notify</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>, + <em class="parameter"><code><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> timeout</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Asynchronously invokes a method on a remote interface. The method +call will not be sent over the wire until the application returns +to the main loop, or blocks in <a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-flush" title="dbus_g_connection_flush ()"><code class="function">dbus_g_connection_flush()</code></a> to write out +pending data. The call will be completed after a timeout, or when +a reply is received. When the call returns, the callback specified +will be invoked; you can then collect the results of the call +(which may be an error, or a reply), use <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()"><code class="function">dbus_g_proxy_end_call()</code></a>. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<p> +TODO this particular function shouldn't die on out of memory, +since you should be able to do a call with large arguments. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td> +<td>the name of the method to invoke</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td> +<td>callback to be invoked when method returns</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data passed to callback</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td> +<td>function called to destroy user_data</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td> +<td>the timeout in milliseconds, or -1 to use a default</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td> +<td>type of the first argument, or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> if there +are no arguments</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>first argument, followed by any further type/value pairs, followed +by <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>call identifier.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-end-call"></a><h3>dbus_g_proxy_end_call ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_proxy_end_call (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="type">DBusGProxyCall</span></a> *call</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_arg_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Collects the results of a method call. The method call was normally +initiated with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()"><code class="function">dbus_g_proxy_end_call()</code></a>. You may use this function +outside of the callback given to dbus_g_proxy_begin_call; in that +case this function will block if the results haven't yet been +received. +</p> +<p> +All D-Bus method calls can fail with a remote error. If this occurs, +the <em class="parameter"><code>error</code></em> will be set and this function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. +</p> +<p> +Otherwise, the "out" parameters and return value of the +method are stored in the provided varargs list. +The list should be terminated with G_TYPE_INVALID. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>call</code></em> :</span></p></td> +<td>the pending call ID from <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()"><code class="function">dbus_g_proxy_begin_call()</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td> +<td>type of first "out" argument, or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> if +there are no "out" arguments</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>return location for first "out" argument, followed by any further +type/location pairs, followed by <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-cancel-call"></a><h3>dbus_g_proxy_cancel_call ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_cancel_call (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxyCall" title="DBusGProxyCall"><span class="type">DBusGProxyCall</span></a> *call</code></em>);</pre> +<p> +Cancels a pending method call. The method call was normally +initiated with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()"><code class="function">dbus_g_proxy_begin_call()</code></a>. This function +may not be used on pending calls that have already been +ended with dbus_g_proxy_end_call. +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>call</code></em> :</span></p></td> +<td>the pending call ID from <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()"><code class="function">dbus_g_proxy_begin_call()</code></a> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-proxy-set-default-timeout"></a><h3>dbus_g_proxy_set_default_timeout ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_set_default_timeout (<em class="parameter"><code><a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, + <em class="parameter"><code><a href="https://www.gnu.org/software/gnutls/reference/gnutls-crypto.html#int"><span class="type">int</span></a> timeout</code></em>);</pre> +<p> +Sets the default timeout to use for a proxy. This timeout will be +used in calls where the timeout is not specified, or is specified to be -1. +If this timeout is also set to -1, libdbus will use a reasonable default +value. +</p> +<p> +This is useful for long-running operations that takes longer than +the default timeout (which is a on the order of magnitude of tens +of seconds). For some applications, consider using a pattern where +the method returns once the operation is underway +(e.g. immediately) and emits a signal when the operation terminates +(though beware of leaking information with/in the signal return value). +</p> +<p> +It is an error to call this method on a proxy that has emitted +the <span class="type">"destroy"</span> signal. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> +<td>a proxy for a remote interface</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td> +<td>the timeout in milliseconds, or -1 to reset to the libdbus default</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 0.75</p> +</div> +</div> +<div class="refsect1"> +<a name="dbus-glib-DBusGProxy.see-also"></a><h2>See Also</h2> +<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="struct DBusGProxy"><span class="type">DBusGProxy</span></a> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib-dbus-gtype-specialized.html b/doc/reference/html/dbus-glib-Specializable-GType-System.html index 0677e1a..8851bb2 100644 --- a/doc/reference/html/dbus-glib-dbus-gtype-specialized.html +++ b/doc/reference/html/dbus-glib-Specializable-GType-System.html @@ -6,168 +6,185 @@ <meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> <link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> <link rel="up" href="ch02.html" title="API Reference"> -<link rel="prev" href="ch02.html" title="API Reference"> -<link rel="next" href="dbus-glib-dbus-glib-lowlevel.html" title="DBus GLib low level"> +<link rel="prev" href="dbus-glib-DBusGProxy.html" title="DBusGProxy"> +<link rel="next" href="dbus-glib-DBus-GLib-low-level.html" title="DBus GLib low level"> <meta name="generator" content="GTK-Doc V1.18 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> <tr valign="middle"> -<td><a accesskey="p" href="ch02.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="p" href="dbus-glib-DBusGProxy.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> <td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> <th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> -<td><a accesskey="n" href="dbus-glib-dbus-glib-lowlevel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +<td><a accesskey="n" href="dbus-glib-DBus-GLib-low-level.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> </tr> <tr><td colspan="5" class="shortcuts"> -<a href="#dbus-glib-dbus-gtype-specialized.synopsis" class="shortcut">Top</a> +<a href="#dbus-glib-Specializable-GType-System.synopsis" class="shortcut">Top</a>  | - <a href="#dbus-glib-dbus-gtype-specialized.description" class="shortcut">Description</a> + <a href="#dbus-glib-Specializable-GType-System.description" class="shortcut">Description</a> </td></tr> </table> <div class="refentry"> -<a name="dbus-glib-dbus-gtype-specialized"></a><div class="titlepage"></div> +<a name="dbus-glib-Specializable-GType-System"></a><div class="titlepage"></div> <div class="refnamediv"><table width="100%"><tr> <td valign="top"> -<h2><span class="refentrytitle"><a name="dbus-glib-dbus-gtype-specialized.top_of_page"></a>Specializable GType System</span></h2> +<h2><span class="refentrytitle"><a name="dbus-glib-Specializable-GType-System.top_of_page"></a>Specializable GType System</span></h2> <p>Specializable GType System — Specialized GTypes</p> </td> <td valign="top" align="right"></td> </tr></table></div> <div class="refsect1"> -<a name="dbus-glib-dbus-gtype-specialized.stability-level"></a><h2>Stability Level</h2> +<a name="dbus-glib-Specializable-GType-System.stability-level"></a><h2>Stability Level</h2> Unstable, unless otherwise indicated </div> <div class="refsynopsisdiv"> -<a name="dbus-glib-dbus-gtype-specialized.synopsis"></a><h2>Synopsis</h2> -<pre class="synopsis"> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext">DBusGTypeSpecializedAppendContext</a>; -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionAppendFunc" title="DBusGTypeSpecializedCollectionAppendFunc ()">*DBusGTypeSpecializedCollectionAppendFunc</a>) - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>); -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionEndAppendFunc" title="DBusGTypeSpecializedCollectionEndAppendFunc ()">*DBusGTypeSpecializedCollectionEndAppendFunc</a>) - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionFixedAccessorFunc" title="DBusGTypeSpecializedCollectionFixedAccessorFunc ()">*DBusGTypeSpecializedCollectionFixedAccessorFunc</a>) +<a name="dbus-glib-Specializable-GType-System.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <dbus/dbus-glib.h> + +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()">*DBusGTypeSpecializedCollectionIterator</a>) + (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()">*DBusGTypeSpecializedMapIterator</a>) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key_val</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value_val</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); + <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext">DBusGTypeSpecializedAppendContext</a>; +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedConstructor" title="DBusGTypeSpecializedConstructor ()">*DBusGTypeSpecializedConstructor</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>); +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedFreeFunc" title="DBusGTypeSpecializedFreeFunc ()">*DBusGTypeSpecializedFreeFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> val</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCopyFunc" title="DBusGTypeSpecializedCopyFunc ()">*DBusGTypeSpecializedCopyFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> src</code></em>); + <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable">DBusGTypeSpecializedVtable</a>; +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionFixedAccessorFunc" title="DBusGTypeSpecializedCollectionFixedAccessorFunc ()">*DBusGTypeSpecializedCollectionFixedAccessorFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *values</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *len</code></em>); -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()">*DBusGTypeSpecializedCollectionIterator</a>) - (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIteratorFunc" title="DBusGTypeSpecializedCollectionIteratorFunc ()">*DBusGTypeSpecializedCollectionIteratorFunc</a>) +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIteratorFunc" title="DBusGTypeSpecializedCollectionIteratorFunc ()">*DBusGTypeSpecializedCollectionIteratorFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); - <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable">DBusGTypeSpecializedCollectionVtable</a>; -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedConstructor" title="DBusGTypeSpecializedConstructor ()">*DBusGTypeSpecializedConstructor</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCopyFunc" title="DBusGTypeSpecializedCopyFunc ()">*DBusGTypeSpecializedCopyFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> src</code></em>); -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedFreeFunc" title="DBusGTypeSpecializedFreeFunc ()">*DBusGTypeSpecializedFreeFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> val</code></em>); -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapAppendFunc" title="DBusGTypeSpecializedMapAppendFunc ()">*DBusGTypeSpecializedMapAppendFunc</a>) - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key</code></em>, +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionAppendFunc" title="DBusGTypeSpecializedCollectionAppendFunc ()">*DBusGTypeSpecializedCollectionAppendFunc</a>) + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>); -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()">*DBusGTypeSpecializedMapIterator</a>) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key_val</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value_val</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); -<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIteratorFunc" title="DBusGTypeSpecializedMapIteratorFunc ()">*DBusGTypeSpecializedMapIteratorFunc</a>) +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionEndAppendFunc" title="DBusGTypeSpecializedCollectionEndAppendFunc ()">*DBusGTypeSpecializedCollectionEndAppendFunc</a>) + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>); + <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable">DBusGTypeSpecializedCollectionVtable</a>; +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIteratorFunc" title="DBusGTypeSpecializedMapIteratorFunc ()">*DBusGTypeSpecializedMapIteratorFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); - <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable">DBusGTypeSpecializedMapVtable</a>; -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructGetMember" title="DBusGTypeSpecializedStructGetMember ()">*DBusGTypeSpecializedStructGetMember</a>) +<span class="returnvalue">void</span> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapAppendFunc" title="DBusGTypeSpecializedMapAppendFunc ()">*DBusGTypeSpecializedMapAppendFunc</a>) + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>); + <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable">DBusGTypeSpecializedMapVtable</a>; +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructGetMember" title="DBusGTypeSpecializedStructGetMember ()">*DBusGTypeSpecializedStructGetMember</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *ret_value</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructSetMember" title="DBusGTypeSpecializedStructSetMember ()">*DBusGTypeSpecializedStructSetMember</a>) +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructSetMember" title="DBusGTypeSpecializedStructSetMember ()">*DBusGTypeSpecializedStructSetMember</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *new_value</code></em>); - <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable">DBusGTypeSpecializedStructVtable</a>; - <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable">DBusGTypeSpecializedVtable</a>; -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-get-fixed" title="dbus_g_type_collection_get_fixed ()">dbus_g_type_collection_get_fixed</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *data_ret</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *len_ret</code></em>); -const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="returnvalue">DBusGTypeSpecializedCollectionVtable</span></a> * <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-peek-vtable" title="dbus_g_type_collection_peek_vtable ()">dbus_g_type_collection_peek_vtable</a> - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> collection_type</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()">dbus_g_type_collection_value_iterate</a> - (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()">dbus_g_type_get_collection</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, + <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable">DBusGTypeSpecializedStructVtable</a>; +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()">dbus_g_type_get_collection</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> specialization</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection-specialization" title="dbus_g_type_get_collection_specialization ()">dbus_g_type_get_collection_specialization</a> - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()">dbus_g_type_get_map</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()">dbus_g_type_get_map</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> key_specialization</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> value_specialization</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map-key-specialization" title="dbus_g_type_get_map_key_specialization ()">dbus_g_type_get_map_key_specialization</a> - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map-value-specialization" title="dbus_g_type_get_map_value_specialization ()">dbus_g_type_get_map_value_specialization</a> - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()">dbus_g_type_get_struct</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-structv" title="dbus_g_type_get_structv ()">dbus_g_type_get_structv</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_members</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>); +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()">dbus_g_type_get_struct</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_type</code></em>, <em class="parameter"><code>...</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct-member-type" title="dbus_g_type_get_struct_member_type ()">dbus_g_type_get_struct_member_type</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>, +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-is-collection" title="dbus_g_type_is_collection ()">dbus_g_type_is_collection</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-is-map" title="dbus_g_type_is_map ()">dbus_g_type_is_map</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-is-struct" title="dbus_g_type_is_struct ()">dbus_g_type_is_struct</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection-specialization" title="dbus_g_type_get_collection_specialization ()">dbus_g_type_get_collection_specialization</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map-key-specialization" title="dbus_g_type_get_map_key_specialization ()">dbus_g_type_get_map_key_specialization</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map-value-specialization" title="dbus_g_type_get_map_value_specialization ()">dbus_g_type_get_map_value_specialization</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct-member-type" title="dbus_g_type_get_struct_member_type ()">dbus_g_type_get_struct_member_type</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct-size" title="dbus_g_type_get_struct_size ()">dbus_g_type_get_struct_size</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-structv" title="dbus_g_type_get_structv ()">dbus_g_type_get_structv</a> (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_members</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-collection" title="dbus_g_type_is_collection ()">dbus_g_type_is_collection</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-map" title="dbus_g_type_is_map ()">dbus_g_type_is_map</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-struct" title="dbus_g_type_is_struct ()">dbus_g_type_is_struct</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="returnvalue">DBusGTypeSpecializedMapVtable</span></a> * <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-peek-vtable" title="dbus_g_type_map_peek_vtable ()">dbus_g_type_map_peek_vtable</a> - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> map_type</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()">dbus_g_type_map_value_iterate</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-collection" title="dbus_g_type_register_collection ()">dbus_g_type_register_collection</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, - <em class="parameter"><code>const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="type">DBusGTypeSpecializedCollectionVtable</span></a> *vtable</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-map" title="dbus_g_type_register_map ()">dbus_g_type_register_map</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, - <em class="parameter"><code>const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="type">DBusGTypeSpecializedMapVtable</span></a> *vtable</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-struct" title="dbus_g_type_register_struct ()">dbus_g_type_register_struct</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, - <em class="parameter"><code>const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="type">DBusGTypeSpecializedStructVtable</span></a> *vtable</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-append" title="dbus_g_type_specialized_collection_append ()">dbus_g_type_specialized_collection_append</a> - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct-size" title="dbus_g_type_get_struct_size ()">dbus_g_type_get_struct_size</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-construct" title="dbus_g_type_specialized_construct ()">dbus_g_type_specialized_construct</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()">dbus_g_type_specialized_init_append</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-append" title="dbus_g_type_specialized_collection_append ()">dbus_g_type_specialized_collection_append</a> + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *elt</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-end-append" title="dbus_g_type_specialized_collection_end_append ()">dbus_g_type_specialized_collection_end_append</a> - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-construct" title="dbus_g_type_specialized_construct ()">dbus_g_type_specialized_construct</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init" title="dbus_g_type_specialized_init ()">dbus_g_type_specialized_init</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()">dbus_g_type_specialized_init_append</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-map-append" title="dbus_g_type_specialized_map_append ()">dbus_g_type_specialized_map_append</a> (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-end-append" title="dbus_g_type_specialized_collection_end_append ()">dbus_g_type_specialized_collection_end_append</a> + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-map-append" title="dbus_g_type_specialized_map_append ()">dbus_g_type_specialized_map_append</a> (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-get" title="dbus_g_type_struct_get ()">dbus_g_type_struct_get</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, - <em class="parameter"><code>...</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-get-member" title="dbus_g_type_struct_get_member ()">dbus_g_type_struct_get_member</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-get-fixed" title="dbus_g_type_collection_get_fixed ()">dbus_g_type_collection_get_fixed</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *data_ret</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *len_ret</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()">dbus_g_type_collection_value_iterate</a> + (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()">dbus_g_type_map_value_iterate</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-get-member" title="dbus_g_type_struct_get_member ()">dbus_g_type_struct_get_member</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>); -const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="returnvalue">DBusGTypeSpecializedStructVtable</span></a> * <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-peek-vtable" title="dbus_g_type_struct_peek_vtable ()">dbus_g_type_struct_peek_vtable</a> - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> struct_type</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-set" title="dbus_g_type_struct_set ()">dbus_g_type_struct_set</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-set-member" title="dbus_g_type_struct_set_member ()">dbus_g_type_struct_set_member</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-get" title="dbus_g_type_struct_get ()">dbus_g_type_struct_get</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, <em class="parameter"><code>...</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-set-member" title="dbus_g_type_struct_set_member ()">dbus_g_type_struct_set_member</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-set" title="dbus_g_type_struct_set ()">dbus_g_type_struct_set</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-value-build-g-variant" title="dbus_g_value_build_g_variant ()">dbus_g_value_build_g_variant</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>); + <em class="parameter"><code>...</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init" title="dbus_g_type_specialized_init ()">dbus_g_type_specialized_init</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-register-collection" title="dbus_g_type_register_collection ()">dbus_g_type_register_collection</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="type">DBusGTypeSpecializedCollectionVtable</span></a> *vtable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-register-map" title="dbus_g_type_register_map ()">dbus_g_type_register_map</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="type">DBusGTypeSpecializedMapVtable</span></a> *vtable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>); +const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="returnvalue">DBusGTypeSpecializedMapVtable</span></a> * <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-map-peek-vtable" title="dbus_g_type_map_peek_vtable ()">dbus_g_type_map_peek_vtable</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> map_type</code></em>); +const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="returnvalue">DBusGTypeSpecializedCollectionVtable</span></a> * <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-peek-vtable" title="dbus_g_type_collection_peek_vtable ()">dbus_g_type_collection_peek_vtable</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> collection_type</code></em>); +const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="returnvalue">DBusGTypeSpecializedStructVtable</span></a> * <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-peek-vtable" title="dbus_g_type_struct_peek_vtable ()">dbus_g_type_struct_peek_vtable</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> struct_type</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-register-struct" title="dbus_g_type_register_struct ()">dbus_g_type_register_struct</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="type">DBusGTypeSpecializedStructVtable</span></a> *vtable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-value-build-g-variant" title="dbus_g_value_build_g_variant ()">dbus_g_value_build_g_variant</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>); +<span class="returnvalue">void</span> <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-value-parse-g-variant" title="dbus_g_value_parse_g_variant ()">dbus_g_value_parse_g_variant</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>); +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-BOOLEAN-ARRAY:CAPS" title="DBUS_TYPE_G_BOOLEAN_ARRAY">DBUS_TYPE_G_BOOLEAN_ARRAY</a> +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UCHAR-ARRAY:CAPS" title="DBUS_TYPE_G_UCHAR_ARRAY">DBUS_TYPE_G_UCHAR_ARRAY</a> +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UINT-ARRAY:CAPS" title="DBUS_TYPE_G_UINT_ARRAY">DBUS_TYPE_G_UINT_ARRAY</a> +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-INT-ARRAY:CAPS" title="DBUS_TYPE_G_INT_ARRAY">DBUS_TYPE_G_INT_ARRAY</a> +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UINT64-ARRAY:CAPS" title="DBUS_TYPE_G_UINT64_ARRAY">DBUS_TYPE_G_UINT64_ARRAY</a> +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-INT64-ARRAY:CAPS" title="DBUS_TYPE_G_INT64_ARRAY">DBUS_TYPE_G_INT64_ARRAY</a> +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-ARRAY:CAPS" title="DBUS_TYPE_G_OBJECT_ARRAY">DBUS_TYPE_G_OBJECT_ARRAY</a> +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-STRING-STRING-HASHTABLE:CAPS" title="DBUS_TYPE_G_STRING_STRING_HASHTABLE">DBUS_TYPE_G_STRING_STRING_HASHTABLE</a> +typedef <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGSignature" title="DBusGSignature">DBusGSignature</a>; +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-SIGNATURE:CAPS" title="DBUS_TYPE_G_SIGNATURE">DBUS_TYPE_G_SIGNATURE</a> +typedef <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGObjectPath" title="DBusGObjectPath">DBusGObjectPath</a>; +#define <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS" title="DBUS_TYPE_G_OBJECT_PATH">DBUS_TYPE_G_OBJECT_PATH</a> </pre> </div> <div class="refsect1"> -<a name="dbus-glib-dbus-gtype-specialized.description"></a><h2>Description</h2> +<a name="dbus-glib-Specializable-GType-System.description"></a><h2>Description</h2> <p> Specialized gtypes are basically a way to allow the definition of recursive <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GTypes</span></a>. It allows the definition of 'containers' which is @@ -212,142 +229,130 @@ the latter. I also need to add some examples. </p> </div> <div class="refsect1"> -<a name="dbus-glib-dbus-gtype-specialized.details"></a><h2>Details</h2> +<a name="dbus-glib-Specializable-GType-System.details"></a><h2>Details</h2> <div class="refsect2"> -<a name="DBusGTypeSpecializedAppendContext"></a><h3>DBusGTypeSpecializedAppendContext</h3> -<pre class="programlisting">typedef struct { - /* public */ - GValue *val; - GType specialization_type; -} DBusGTypeSpecializedAppendContext; -</pre> +<a name="DBusGTypeSpecializedCollectionIterator"></a><h3>DBusGTypeSpecializedCollectionIterator ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionIterator) + (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p> -A context for appending. There are more fields, which are private. +A library-user-supplied function, called for each element in the +collection when <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> is called. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *<em class="structfield"><code><a name="DBusGTypeSpecializedAppendContext.val"></a>val</code></em>;</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing the array to which you're appending</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>an element of the collection</td> </tr> <tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedAppendContext.specialization-type"></a>specialization_type</code></em>;</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of the array's elements</td> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the data supplied when calling +<a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> +</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedCollectionAppendFunc"></a><h3>DBusGTypeSpecializedCollectionAppendFunc ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionAppendFunc) - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>);</pre> -<p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-append" title="dbus_g_type_specialized_collection_append ()"><code class="function">dbus_g_type_specialized_collection_append()</code></a>. -</p> +<a name="DBusGTypeSpecializedMapIterator"></a><h3>DBusGTypeSpecializedMapIterator ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedMapIterator) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key_val</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value_val</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p> -This function should use the <em class="parameter"><code>val</code></em> and <em class="parameter"><code>specialization_type</code></em> members of <em class="parameter"><code>ctx</code></em>. +A library-user-supplied function, called for each key/value pair in the +collection when <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()"><code class="function">dbus_g_type_map_value_iterate()</code></a> is called. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> -<td>an appending context returned by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> -</td> +<td><p><span class="term"><em class="parameter"><code>key_val</code></em> :</span></p></td> +<td>a key from the map</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td> -<td>a value to copy into the collection</td> +<td><p><span class="term"><em class="parameter"><code>value_val</code></em> :</span></p></td> +<td>a value from the map</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the data supplied when calling +<a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()"><code class="function">dbus_g_type_map_value_iterate()</code></a> +</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedCollectionEndAppendFunc"></a><h3>DBusGTypeSpecializedCollectionEndAppendFunc ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionEndAppendFunc) - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>);</pre> -<p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-end-append" title="dbus_g_type_specialized_collection_end_append ()"><code class="function">dbus_g_type_specialized_collection_end_append()</code></a>. -</p> +<a name="DBusGTypeSpecializedAppendContext"></a><h3>DBusGTypeSpecializedAppendContext</h3> +<pre class="programlisting">typedef struct { + /* public */ + GValue *val; + GType specialization_type; +} DBusGTypeSpecializedAppendContext; +</pre> <p> -This function should use the <em class="parameter"><code>val</code></em> and <em class="parameter"><code>specialization_type</code></em> members of <em class="parameter"><code>ctx</code></em>. +A context for appending. There are more fields, which are private. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> -<td>an appending context returned by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> -</td> -</tr></tbody> +<tbody> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *<em class="structfield"><code><a name="DBusGTypeSpecializedAppendContext.val"></a>val</code></em>;</span></p></td> +<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing the array to which you're appending</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedAppendContext.specialization-type"></a>specialization_type</code></em>;</span></p></td> +<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of the array's elements</td> +</tr> +</tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedCollectionFixedAccessorFunc"></a><h3>DBusGTypeSpecializedCollectionFixedAccessorFunc ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*DBusGTypeSpecializedCollectionFixedAccessorFunc) - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *values</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *len</code></em>);</pre> +<a name="DBusGTypeSpecializedConstructor"></a><h3>DBusGTypeSpecializedConstructor ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (*DBusGTypeSpecializedConstructor) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);</pre> <p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-get-fixed" title="dbus_g_type_collection_get_fixed ()"><code class="function">dbus_g_type_collection_get_fixed()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with type -<em class="parameter"><code>type</code></em>, containing <em class="parameter"><code>instance</code></em>. + </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> -<td>a specialized collection boxed type</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td> -<td>an instance of <em class="parameter"><code>type</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td> -<td>used to return a pointer to the contents of <em class="parameter"><code>instance</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td> -<td>used to return the number of elements in <em class="parameter"><code>instance</code></em> -</td> +<td>a specialized boxed type</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</td> +<td>a new instance of <em class="parameter"><code>type</code></em> +</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedCollectionIterator"></a><h3>DBusGTypeSpecializedCollectionIterator ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionIterator) - (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<a name="DBusGTypeSpecializedFreeFunc"></a><h3>DBusGTypeSpecializedFreeFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedFreeFunc) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> val</code></em>);</pre> <p> -A library-user-supplied function, called for each element in the -collection when <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> is called. +Frees <em class="parameter"><code>val</code></em> according to <em class="parameter"><code>type</code></em>. This is analogous to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GBoxedFreeFunc"><span class="type">GBoxedFreeFunc</span></a>, but +can use information from <em class="parameter"><code>type</code></em> (for instance to free the contents of a +container before freeing the actual container). </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>an element of the collection</td> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>a specialized boxed type</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>the data supplied when calling -<a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> +<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td> +<td>an instance of <em class="parameter"><code>type</code></em> </td> </tr> </tbody> @@ -355,35 +360,29 @@ collection when <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedCollectionIteratorFunc"></a><h3>DBusGTypeSpecializedCollectionIteratorFunc ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionIteratorFunc) - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<a name="DBusGTypeSpecializedCopyFunc"></a><h3>DBusGTypeSpecializedCopyFunc ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (*DBusGTypeSpecializedCopyFunc) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> src</code></em>);</pre> <p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with -type <em class="parameter"><code>type</code></em>, containing <em class="parameter"><code>instance</code></em>. +Copies <em class="parameter"><code>src</code></em> according to <em class="parameter"><code>type</code></em>. This is analogous to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GBoxedCopyFunc"><span class="type">GBoxedCopyFunc</span></a>, but +can use information from <em class="parameter"><code>type</code></em> (for instance to copy each element of a +collection). </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> -<td>a specialized collection boxed type</td> +<td>a specialized boxed type</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> <td>an instance of <em class="parameter"><code>type</code></em> </td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td> -<td>the function to call for each element</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>data to pass to <em class="parameter"><code>iterator</code></em> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a deep copy of <em class="parameter"><code>src</code></em> </td> </tr> </tbody> @@ -391,99 +390,122 @@ type <em class="parameter"><code>type</code></em>, containing <em class="paramet </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedCollectionVtable"></a><h3>DBusGTypeSpecializedCollectionVtable</h3> +<a name="DBusGTypeSpecializedVtable"></a><h3>DBusGTypeSpecializedVtable</h3> <pre class="programlisting">typedef struct { - DBusGTypeSpecializedVtable base_vtable; - DBusGTypeSpecializedCollectionFixedAccessorFunc fixed_accessor; - DBusGTypeSpecializedCollectionIteratorFunc iterator; - DBusGTypeSpecializedCollectionAppendFunc append_func; - DBusGTypeSpecializedCollectionEndAppendFunc end_append_func; -} DBusGTypeSpecializedCollectionVtable; + DBusGTypeSpecializedConstructor constructor; + DBusGTypeSpecializedFreeFunc free_func; + DBusGTypeSpecializedCopyFunc copy_func; + GDestroyNotify simple_free_func; /* for type-independent freeing if possible */ +} DBusGTypeSpecializedVtable; </pre> <p> -A table of methods used to implement specialized collection behaviour -on user-defined types. At least <em class="parameter"><code>iterator</code></em> and <em class="parameter"><code>append_func</code></em> must be -implemented. +A table of methods used to implement specialized container behaviour on +user-defined collections, maps and structs. Exactly one of <em class="parameter"><code>free_func</code></em> and +<em class="parameter"><code>simple_free_func</code></em> must be implemented; the other must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. +<em class="parameter"><code>constructor</code></em> and <em class="parameter"><code>copy_func</code></em> must always be implemented. +</p> +<p> +There are additional members, which are reserved for future expansion and +must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable"><span class="type">DBusGTypeSpecializedVtable</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.base-vtable"></a>base_vtable</code></em>;</span></p></td> -<td>base methods shared between collections and other types</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionFixedAccessorFunc" title="DBusGTypeSpecializedCollectionFixedAccessorFunc ()"><span class="type">DBusGTypeSpecializedCollectionFixedAccessorFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.fixed-accessor"></a>fixed_accessor</code></em>;</span></p></td> -<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, provides access to the contents of this -collection, as documented for <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-get-fixed" title="dbus_g_type_collection_get_fixed ()"><code class="function">dbus_g_type_collection_get_fixed()</code></a> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedConstructor" title="DBusGTypeSpecializedConstructor ()"><span class="type">DBusGTypeSpecializedConstructor</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.constructor"></a>constructor</code></em>;</span></p></td> +<td>returns a new, blank instance of the <em class="parameter"><code>type</code></em> </td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIteratorFunc" title="DBusGTypeSpecializedCollectionIteratorFunc ()"><span class="type">DBusGTypeSpecializedCollectionIteratorFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.iterator"></a>iterator</code></em>;</span></p></td> -<td>iterates through the members of <em class="parameter"><code>instance</code></em> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedFreeFunc" title="DBusGTypeSpecializedFreeFunc ()"><span class="type">DBusGTypeSpecializedFreeFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.free-func"></a>free_func</code></em>;</span></p></td> +<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, frees the <em class="parameter"><code>type</code></em> instance <em class="parameter"><code>val</code></em> </td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionAppendFunc" title="DBusGTypeSpecializedCollectionAppendFunc ()"><span class="type">DBusGTypeSpecializedCollectionAppendFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.append-func"></a>append_func</code></em>;</span></p></td> -<td>appends a new member to <em class="parameter"><code>instance</code></em> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCopyFunc" title="DBusGTypeSpecializedCopyFunc ()"><span class="type">DBusGTypeSpecializedCopyFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.copy-func"></a>copy_func</code></em>;</span></p></td> +<td>returns a "deep copy" of the <em class="parameter"><code>type</code></em> instance <em class="parameter"><code>val</code></em> </td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionEndAppendFunc" title="DBusGTypeSpecializedCollectionEndAppendFunc ()"><span class="type">DBusGTypeSpecializedCollectionEndAppendFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.end-append-func"></a>end_append_func</code></em>;</span></p></td> -<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, called after each group of calls to -the <em class="parameter"><code>append_func</code></em> -</td> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.simple-free-func"></a>simple_free_func</code></em>;</span></p></td> +<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, frees its argument</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedConstructor"></a><h3>DBusGTypeSpecializedConstructor ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (*DBusGTypeSpecializedConstructor) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);</pre> +<a name="DBusGTypeSpecializedCollectionFixedAccessorFunc"></a><h3>DBusGTypeSpecializedCollectionFixedAccessorFunc ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*DBusGTypeSpecializedCollectionFixedAccessorFunc) + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *values</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *len</code></em>);</pre> <p> - +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-get-fixed" title="dbus_g_type_collection_get_fixed ()"><code class="function">dbus_g_type_collection_get_fixed()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with type +<em class="parameter"><code>type</code></em>, containing <em class="parameter"><code>instance</code></em>. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> -<td>a specialized boxed type</td> +<td>a specialized collection boxed type</td> </tr> <tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a new instance of <em class="parameter"><code>type</code></em> +<td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td> +<td>an instance of <em class="parameter"><code>type</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td> +<td>used to return a pointer to the contents of <em class="parameter"><code>instance</code></em> </td> </tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td> +<td>used to return the number of elements in <em class="parameter"><code>instance</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</td> +</tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedCopyFunc"></a><h3>DBusGTypeSpecializedCopyFunc ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (*DBusGTypeSpecializedCopyFunc) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> src</code></em>);</pre> +<a name="DBusGTypeSpecializedCollectionIteratorFunc"></a><h3>DBusGTypeSpecializedCollectionIteratorFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionIteratorFunc) + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p> -Copies <em class="parameter"><code>src</code></em> according to <em class="parameter"><code>type</code></em>. This is analogous to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GBoxedCopyFunc"><span class="type">GBoxedCopyFunc</span></a>, but -can use information from <em class="parameter"><code>type</code></em> (for instance to copy each element of a -collection). +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with +type <em class="parameter"><code>type</code></em>, containing <em class="parameter"><code>instance</code></em>. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> -<td>a specialized boxed type</td> +<td>a specialized collection boxed type</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td> <td>an instance of <em class="parameter"><code>type</code></em> </td> </tr> <tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a deep copy of <em class="parameter"><code>src</code></em> +<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td> +<td>the function to call for each element</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>data to pass to <em class="parameter"><code>iterator</code></em> </td> </tr> </tbody> @@ -491,87 +513,94 @@ collection). </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedFreeFunc"></a><h3>DBusGTypeSpecializedFreeFunc ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedFreeFunc) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> val</code></em>);</pre> +<a name="DBusGTypeSpecializedCollectionAppendFunc"></a><h3>DBusGTypeSpecializedCollectionAppendFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionAppendFunc) + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>);</pre> <p> -Frees <em class="parameter"><code>val</code></em> according to <em class="parameter"><code>type</code></em>. This is analogous to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GBoxedFreeFunc"><span class="type">GBoxedFreeFunc</span></a>, but -can use information from <em class="parameter"><code>type</code></em> (for instance to free the contents of a -container before freeing the actual container). +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-append" title="dbus_g_type_specialized_collection_append ()"><code class="function">dbus_g_type_specialized_collection_append()</code></a>. +</p> +<p> +This function should use the <em class="parameter"><code>val</code></em> and <em class="parameter"><code>specialization_type</code></em> members of <em class="parameter"><code>ctx</code></em>. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> -<td>a specialized boxed type</td> +<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> +<td>an appending context returned by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> +</td> </tr> <tr> <td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td> -<td>an instance of <em class="parameter"><code>type</code></em> -</td> +<td>a value to copy into the collection</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedMapAppendFunc"></a><h3>DBusGTypeSpecializedMapAppendFunc ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedMapAppendFunc) - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>);</pre> +<a name="DBusGTypeSpecializedCollectionEndAppendFunc"></a><h3>DBusGTypeSpecializedCollectionEndAppendFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedCollectionEndAppendFunc) + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>);</pre> <p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-map-append" title="dbus_g_type_specialized_map_append ()"><code class="function">dbus_g_type_specialized_map_append()</code></a>. +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-end-append" title="dbus_g_type_specialized_collection_end_append ()"><code class="function">dbus_g_type_specialized_collection_end_append()</code></a>. </p> <p> -This function should use the <em class="parameter"><code>val</code></em> and <em class="parameter"><code>specialization_type</code></em> members of <em class="parameter"><code>ctx</code></em>, -and replace any existing value with key equal to <em class="parameter"><code>key</code></em>. +This function should use the <em class="parameter"><code>val</code></em> and <em class="parameter"><code>specialization_type</code></em> members of <em class="parameter"><code>ctx</code></em>. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> -<tbody> -<tr> +<tbody><tr> <td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> -<td>an appending context returned by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> +<td>an appending context returned by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> </td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td> -<td>a key to add to the collection</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td> -<td>a value to add to the collection</td> -</tr> -</tbody> +</tr></tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedMapIterator"></a><h3>DBusGTypeSpecializedMapIterator ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedMapIterator) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key_val</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value_val</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<a name="DBusGTypeSpecializedCollectionVtable"></a><h3>DBusGTypeSpecializedCollectionVtable</h3> +<pre class="programlisting">typedef struct { + DBusGTypeSpecializedVtable base_vtable; + DBusGTypeSpecializedCollectionFixedAccessorFunc fixed_accessor; + DBusGTypeSpecializedCollectionIteratorFunc iterator; + DBusGTypeSpecializedCollectionAppendFunc append_func; + DBusGTypeSpecializedCollectionEndAppendFunc end_append_func; +} DBusGTypeSpecializedCollectionVtable; +</pre> <p> -A library-user-supplied function, called for each key/value pair in the -collection when <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()"><code class="function">dbus_g_type_map_value_iterate()</code></a> is called. +A table of methods used to implement specialized collection behaviour +on user-defined types. At least <em class="parameter"><code>iterator</code></em> and <em class="parameter"><code>append_func</code></em> must be +implemented. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>key_val</code></em> :</span></p></td> -<td>a key from the map</td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable"><span class="type">DBusGTypeSpecializedVtable</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.base-vtable"></a>base_vtable</code></em>;</span></p></td> +<td>base methods shared between collections and other types</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>value_val</code></em> :</span></p></td> -<td>a value from the map</td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionFixedAccessorFunc" title="DBusGTypeSpecializedCollectionFixedAccessorFunc ()"><span class="type">DBusGTypeSpecializedCollectionFixedAccessorFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.fixed-accessor"></a>fixed_accessor</code></em>;</span></p></td> +<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, provides access to the contents of this +collection, as documented for <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-get-fixed" title="dbus_g_type_collection_get_fixed ()"><code class="function">dbus_g_type_collection_get_fixed()</code></a> +</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>the data supplied when calling -<a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()"><code class="function">dbus_g_type_map_value_iterate()</code></a> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIteratorFunc" title="DBusGTypeSpecializedCollectionIteratorFunc ()"><span class="type">DBusGTypeSpecializedCollectionIteratorFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.iterator"></a>iterator</code></em>;</span></p></td> +<td>iterates through the members of <em class="parameter"><code>instance</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionAppendFunc" title="DBusGTypeSpecializedCollectionAppendFunc ()"><span class="type">DBusGTypeSpecializedCollectionAppendFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.append-func"></a>append_func</code></em>;</span></p></td> +<td>appends a new member to <em class="parameter"><code>instance</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionEndAppendFunc" title="DBusGTypeSpecializedCollectionEndAppendFunc ()"><span class="type">DBusGTypeSpecializedCollectionEndAppendFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedCollectionVtable.end-append-func"></a>end_append_func</code></em>;</span></p></td> +<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, called after each group of calls to +the <em class="parameter"><code>append_func</code></em> </td> </tr> </tbody> @@ -583,10 +612,10 @@ collection when <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus <pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedMapIteratorFunc) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()"><code class="function">dbus_g_type_map_value_iterate()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-map-value-iterate" title="dbus_g_type_map_value_iterate ()"><code class="function">dbus_g_type_map_value_iterate()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with type <em class="parameter"><code>type</code></em>, containing <em class="parameter"><code>instance</code></em>. </p> <div class="variablelist"><table border="0"> @@ -615,6 +644,39 @@ type <em class="parameter"><code>type</code></em>, containing <em class="paramet </div> <hr> <div class="refsect2"> +<a name="DBusGTypeSpecializedMapAppendFunc"></a><h3>DBusGTypeSpecializedMapAppendFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*DBusGTypeSpecializedMapAppendFunc) + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>);</pre> +<p> +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-map-append" title="dbus_g_type_specialized_map_append ()"><code class="function">dbus_g_type_specialized_map_append()</code></a>. +</p> +<p> +This function should use the <em class="parameter"><code>val</code></em> and <em class="parameter"><code>specialization_type</code></em> members of <em class="parameter"><code>ctx</code></em>, +and replace any existing value with key equal to <em class="parameter"><code>key</code></em>. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> +<td>an appending context returned by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td> +<td>a key to add to the collection</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td> +<td>a value to add to the collection</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> <a name="DBusGTypeSpecializedMapVtable"></a><h3>DBusGTypeSpecializedMapVtable</h3> <pre class="programlisting">typedef struct { DBusGTypeSpecializedVtable base_vtable; @@ -630,16 +692,16 @@ on user-defined types. Both methods must be implemented. <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable"><span class="type">DBusGTypeSpecializedVtable</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedMapVtable.base-vtable"></a>base_vtable</code></em>;</span></p></td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable"><span class="type">DBusGTypeSpecializedVtable</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedMapVtable.base-vtable"></a>base_vtable</code></em>;</span></p></td> <td>base methods shared between maps and other types</td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIteratorFunc" title="DBusGTypeSpecializedMapIteratorFunc ()"><span class="type">DBusGTypeSpecializedMapIteratorFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedMapVtable.iterator"></a>iterator</code></em>;</span></p></td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIteratorFunc" title="DBusGTypeSpecializedMapIteratorFunc ()"><span class="type">DBusGTypeSpecializedMapIteratorFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedMapVtable.iterator"></a>iterator</code></em>;</span></p></td> <td>iterates through the members of <em class="parameter"><code>instance</code></em> </td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapAppendFunc" title="DBusGTypeSpecializedMapAppendFunc ()"><span class="type">DBusGTypeSpecializedMapAppendFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedMapVtable.append-func"></a>append_func</code></em>;</span></p></td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapAppendFunc" title="DBusGTypeSpecializedMapAppendFunc ()"><span class="type">DBusGTypeSpecializedMapAppendFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedMapVtable.append-func"></a>append_func</code></em>;</span></p></td> <td>adds a new key/value pair to <em class="parameter"><code>instance</code></em> </td> </tr> @@ -655,7 +717,7 @@ on user-defined types. Both methods must be implemented. <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *ret_value</code></em>);</pre> <p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-get-member" title="dbus_g_type_struct_get_member ()"><code class="function">dbus_g_type_struct_get_member()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with type <em class="parameter"><code>type</code></em>, +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-get-member" title="dbus_g_type_struct_get_member ()"><code class="function">dbus_g_type_struct_get_member()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with type <em class="parameter"><code>type</code></em>, containing <em class="parameter"><code>instance</code></em>. </p> <div class="variablelist"><table border="0"> @@ -697,7 +759,7 @@ member of <em class="parameter"><code>type</code></em> <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *new_value</code></em>);</pre> <p> -Implements <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-set-member" title="dbus_g_type_struct_set_member ()"><code class="function">dbus_g_type_struct_set_member()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with type <em class="parameter"><code>type</code></em>, +Implements <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-set-member" title="dbus_g_type_struct_set_member ()"><code class="function">dbus_g_type_struct_set_member()</code></a> for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> with type <em class="parameter"><code>type</code></em>, containing <em class="parameter"><code>instance</code></em>. </p> <div class="variablelist"><table border="0"> @@ -747,15 +809,15 @@ on user-defined types. Both methods must be implemented. <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable"><span class="type">DBusGTypeSpecializedVtable</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedStructVtable.base-vtable"></a>base_vtable</code></em>;</span></p></td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedVtable" title="DBusGTypeSpecializedVtable"><span class="type">DBusGTypeSpecializedVtable</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedStructVtable.base-vtable"></a>base_vtable</code></em>;</span></p></td> <td>base methods shared between maps and other types</td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructGetMember" title="DBusGTypeSpecializedStructGetMember ()"><span class="type">DBusGTypeSpecializedStructGetMember</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedStructVtable.get-member"></a>get_member</code></em>;</span></p></td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructGetMember" title="DBusGTypeSpecializedStructGetMember ()"><span class="type">DBusGTypeSpecializedStructGetMember</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedStructVtable.get-member"></a>get_member</code></em>;</span></p></td> <td>returns a member by its index</td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructSetMember" title="DBusGTypeSpecializedStructSetMember ()"><span class="type">DBusGTypeSpecializedStructSetMember</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedStructVtable.set-member"></a>set_member</code></em>;</span></p></td> +<td><p><span class="term"><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructSetMember" title="DBusGTypeSpecializedStructSetMember ()"><span class="type">DBusGTypeSpecializedStructSetMember</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedStructVtable.set-member"></a>set_member</code></em>;</span></p></td> <td>sets a member by its index</td> </tr> </tbody> @@ -763,271 +825,227 @@ on user-defined types. Both methods must be implemented. </div> <hr> <div class="refsect2"> -<a name="DBusGTypeSpecializedVtable"></a><h3>DBusGTypeSpecializedVtable</h3> -<pre class="programlisting">typedef struct { - DBusGTypeSpecializedConstructor constructor; - DBusGTypeSpecializedFreeFunc free_func; - DBusGTypeSpecializedCopyFunc copy_func; - GDestroyNotify simple_free_func; /* for type-independent freeing if possible */ -} DBusGTypeSpecializedVtable; -</pre> -<p> -A table of methods used to implement specialized container behaviour on -user-defined collections, maps and structs. Exactly one of <em class="parameter"><code>free_func</code></em> and -<em class="parameter"><code>simple_free_func</code></em> must be implemented; the other must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -<em class="parameter"><code>constructor</code></em> and <em class="parameter"><code>copy_func</code></em> must always be implemented. -</p> +<a name="dbus-g-type-get-collection"></a><h3>dbus_g_type_get_collection ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_collection (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> specialization</code></em>);</pre> <p> -There are additional members, which are reserved for future expansion and -must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. +Gets a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular collection instance, +creating the type if not already created. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedConstructor" title="DBusGTypeSpecializedConstructor ()"><span class="type">DBusGTypeSpecializedConstructor</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.constructor"></a>constructor</code></em>;</span></p></td> -<td>returns a new, blank instance of the <em class="parameter"><code>type</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedFreeFunc" title="DBusGTypeSpecializedFreeFunc ()"><span class="type">DBusGTypeSpecializedFreeFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.free-func"></a>free_func</code></em>;</span></p></td> -<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, frees the <em class="parameter"><code>type</code></em> instance <em class="parameter"><code>val</code></em> -</td> +<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> +<td>a string specifying a registered collection type</td> </tr> <tr> -<td><p><span class="term"><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCopyFunc" title="DBusGTypeSpecializedCopyFunc ()"><span class="type">DBusGTypeSpecializedCopyFunc</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.copy-func"></a>copy_func</code></em>;</span></p></td> -<td>returns a "deep copy" of the <em class="parameter"><code>type</code></em> instance <em class="parameter"><code>val</code></em> -</td> +<td><p><span class="term"><em class="parameter"><code>specialization</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of collection elements</td> </tr> <tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> <em class="structfield"><code><a name="DBusGTypeSpecializedVtable.simple-free-func"></a>simple_free_func</code></em>;</span></p></td> -<td>if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, frees its argument</td> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-collection-get-fixed"></a><h3>dbus_g_type_collection_get_fixed ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_collection_get_fixed (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *data_ret</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *len_ret</code></em>);</pre> -<p> -Calling this function is likely to be a bad idea. Consider using -<a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> instead. -</p> -<p> -On success, <em class="parameter"><code>data_ret</code></em> is a pointer to the underlying data in a collection -of fixed-length fundamental types. Knowledge of the underlying data model -of the collection is needed in order to use <em class="parameter"><code>data_ret</code></em> correctly. -</p> -<p> -It is an error to call this function on a specialized type that is not a -collection, or on a collection that does not have a <em class="parameter"><code>fixed_accessor</code></em> in its -<a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="type">DBusGTypeSpecializedCollectionVtable</span></a>. -</p> +<a name="dbus-g-type-get-map"></a><h3>dbus_g_type_get_map ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_map (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> key_specialization</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> value_specialization</code></em>);</pre> <p> -Specialized <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a>s are the only types provided by dbus-glib that -can be used with this function; user-defined types might also work. +Gets a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular map instance, +creating the type if not already created. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a GValue containing a boxed specialized collection -that has a <em class="parameter"><code>fixed_accessor</code></em> in its vtable</td> +<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> +<td>a string specifying a registered map type</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>data_ret</code></em> :</span></p></td> -<td>used to return a pointer to the fixed data, which must not be -modified (for instance, for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>, this would point -to an array of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>)</td> +<td><p><span class="term"><em class="parameter"><code>key_specialization</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of keys</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>len_ret</code></em> :</span></p></td> -<td>used to return the length (counting collection elements, not -bytes: in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> containing one <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>, this would be 1)</td> +<td><p><span class="term"><em class="parameter"><code>value_specialization</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of values</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</td> +<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-collection-peek-vtable"></a><h3>dbus_g_type_collection_peek_vtable ()</h3> -<pre class="programlisting">const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="returnvalue">DBusGTypeSpecializedCollectionVtable</span></a> * dbus_g_type_collection_peek_vtable - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> collection_type</code></em>);</pre> +<a name="dbus-g-type-get-structv"></a><h3>dbus_g_type_get_structv ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_structv (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_members</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);</pre> <p> -Peek the vtable for a given collection specialization +Gets a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular struct instance, +creating the type if not already created. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>collection_type</code></em> :</span></p></td> -<td>a gtype of a collection specialization</td> +<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> +<td>a string specifying a registered struct type</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>num_members</code></em> :</span></p></td> +<td>number of members in the struct</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>types</code></em> :</span></p></td> +<td>an array specufying a GType for each struct element</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the vtable</td> +<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-collection-value-iterate"></a><h3>dbus_g_type_collection_value_iterate ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_collection_value_iterate - (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<a name="dbus-g-type-get-struct"></a><h3>dbus_g_type_get_struct ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_struct (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_type</code></em>, + <em class="parameter"><code>...</code></em>);</pre> <p> -Calls the given function for each element of the collection. -The function is passed a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing the element and the given -<em class="parameter"><code>user_data</code></em> parameter. The collection may not be modified while iterating over -it. +Varags methsod to get a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular struct instance, +creating the type if not already created. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> holding a collection type.</td> +<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> +<td>a string specifying a registered struct type</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td> -<td>a function to call for each element</td> +<td><p><span class="term"><em class="parameter"><code>first_type</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for the struct's first member</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data to pass to the <em class="parameter"><code>iterator</code></em> -</td> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>more GTypes for the struct's members, terminated by G_TYPE_INVALID</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-get-collection"></a><h3>dbus_g_type_get_collection ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_collection (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> specialization</code></em>);</pre> +<a name="dbus-g-type-is-collection"></a><h3>dbus_g_type_is_collection ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_is_collection (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> <p> -Gets a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular collection instance, -creating the type if not already created. +Tests if a given GType is a collection. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> -<td>a string specifying a registered collection type</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>specialization</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of collection elements</td> +<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> +<td>a GType to test</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> +<td>true if the given GType is a collection</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-get-collection-specialization"></a><h3>dbus_g_type_get_collection_specialization ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_collection_specialization - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> +<a name="dbus-g-type-is-map"></a><h3>dbus_g_type_is_map ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_is_map (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> <p> -Return the type of each element in collections of type <em class="parameter"><code>gtype</code></em>. -It is an error to call this function on a non-collection type. +Tests if a given GType is a map, +i.e. it was created with <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a>. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a collection <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>, as created by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()"><code class="function">dbus_g_type_get_collection()</code></a> -</td> +<td>a GType to test</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the element type for a given collection GType.</td> +<td>true if the given GType is a map</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-get-map"></a><h3>dbus_g_type_get_map ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_map (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> key_specialization</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> value_specialization</code></em>);</pre> +<a name="dbus-g-type-is-struct"></a><h3>dbus_g_type_is_struct ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_is_struct (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> <p> -Gets a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular map instance, -creating the type if not already created. +Tests if a given GType is a struct, +i.e. it was created with <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a> </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> -<td>a string specifying a registered map type</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>key_specialization</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of keys</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>value_specialization</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of values</td> +<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> +<td>a GType to test</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> +<td>true if the given GType is a struct</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-get-map-key-specialization"></a><h3>dbus_g_type_get_map_key_specialization ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_map_key_specialization +<a name="dbus-g-type-get-collection-specialization"></a><h3>dbus_g_type_get_collection_specialization ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_collection_specialization (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> <p> -Return the type of the keys in maps of type <em class="parameter"><code>gtype</code></em>. -It is an error to call this function on a non-map type. +Return the type of each element in collections of type <em class="parameter"><code>gtype</code></em>. +It is an error to call this function on a non-collection type. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a map <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>, as created by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a> +<td>a collection <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>, as created by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()"><code class="function">dbus_g_type_get_collection()</code></a> </td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the key type for a given map <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>.</td> +<td>the element type for a given collection GType.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-get-map-value-specialization"></a><h3>dbus_g_type_get_map_value_specialization ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_map_value_specialization +<a name="dbus-g-type-get-map-key-specialization"></a><h3>dbus_g_type_get_map_key_specialization ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_map_key_specialization (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> <p> -Return the type of the values in maps of type <em class="parameter"><code>gtype</code></em>. +Return the type of the keys in maps of type <em class="parameter"><code>gtype</code></em>. It is an error to call this function on a non-map type. </p> <div class="variablelist"><table border="0"> @@ -1035,44 +1053,35 @@ It is an error to call this function on a non-map type. <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a map GType, as created by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a>.</td> +<td>a map <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>, as created by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a> +</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the value type for a given map GType.</td> +<td>the key type for a given map <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-get-struct"></a><h3>dbus_g_type_get_struct ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_struct (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> first_type</code></em>, - <em class="parameter"><code>...</code></em>);</pre> +<a name="dbus-g-type-get-map-value-specialization"></a><h3>dbus_g_type_get_map_value_specialization ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_map_value_specialization + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> <p> -Varags methsod to get a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular struct instance, -creating the type if not already created. +Return the type of the values in maps of type <em class="parameter"><code>gtype</code></em>. +It is an error to call this function on a non-map type. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> -<td>a string specifying a registered struct type</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>first_type</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for the struct's first member</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> -<td>more GTypes for the struct's members, terminated by G_TYPE_INVALID</td> +<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> +<td>a map GType, as created by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a>.</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> +<td>the value type for a given map GType.</td> </tr> </tbody> </table></div> @@ -1091,7 +1100,7 @@ It is an error to call this function on a non-struct type. <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a struct GType, as created with <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a> +<td>a struct GType, as created with <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a> </td> </tr> <tr> @@ -1101,7 +1110,7 @@ It is an error to call this function on a non-struct type. <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> <td>the type for a given member of a struct <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>, -or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> if <em class="parameter"><code>member</code></em> >= <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct-size" title="dbus_g_type_get_struct_size ()"><code class="function">dbus_g_type_get_struct_size()</code></a> +or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"><code class="literal">G_TYPE_INVALID</code></a> if <em class="parameter"><code>member</code></em> >= <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct-size" title="dbus_g_type_get_struct_size ()"><code class="function">dbus_g_type_get_struct_size()</code></a> </td> </tr> </tbody> @@ -1120,7 +1129,7 @@ It is an error to call this function on a non-struct type. <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a struct GType, as created with <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a>.</td> +<td>a struct GType, as created with <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a>.</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> @@ -1131,133 +1140,187 @@ It is an error to call this function on a non-struct type. </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-get-structv"></a><h3>dbus_g_type_get_structv ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_g_type_get_structv (<em class="parameter"><code>const <span class="type">char</span> *container</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_members</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);</pre> +<a name="dbus-g-type-specialized-construct"></a><h3>dbus_g_type_specialized_construct ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> dbus_g_type_specialized_construct (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> <p> -Gets a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for a particular struct instance, -creating the type if not already created. +Create an instance of a given specialized type. +The structure created and returned will depend on the container type of the +GType. E.g. If the given type was created by +dbus_g_type_get_collection("GArray", G_TYPE_INT), +then this will return a GArray with element_size of sizeof(int) </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td> -<td>a string specifying a registered struct type</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>num_members</code></em> :</span></p></td> -<td>number of members in the struct</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>types</code></em> :</span></p></td> -<td>an array specufying a GType for each struct element</td> +<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> +<td>a specialized <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>, as created by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()"><code class="function">dbus_g_type_get_collection()</code></a>, +<a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a> or <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a> +</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of that instance</td> +<td>a pointer to a newly constructed instance of the given type.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-is-collection"></a><h3>dbus_g_type_is_collection ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_is_collection (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> +<a name="dbus-g-type-specialized-init-append"></a><h3>dbus_g_type_specialized_init_append ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_init_append (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>);</pre> <p> -Tests if a given GType is a collection. +Create a new context for adding elements to a collection or key/value pairs +to a map. You generally don't need or want to use this.. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a GType to test</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing an instance of specialized type</td> </tr> <tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>true if the given GType is a collection</td> +<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> +<td>a <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> in which to return a new appending context.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-is-map"></a><h3>dbus_g_type_is_map ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_is_map (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> +<a name="dbus-g-type-specialized-collection-append"></a><h3>dbus_g_type_specialized_collection_append ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_collection_append + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *elt</code></em>);</pre> <p> -Tests if a given GType is a map, -i.e. it was created with <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a>. +Appends a given element to the end of a collection. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a GType to test</td> +<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> +<td>a context created by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> +for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a collection</td> </tr> <tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>true if the given GType is a map</td> +<td><p><span class="term"><em class="parameter"><code>elt</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing an element to append to the collection</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-is-struct"></a><h3>dbus_g_type_is_struct ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_is_struct (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> +<a name="dbus-g-type-specialized-collection-end-append"></a><h3>dbus_g_type_specialized_collection_end_append ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_collection_end_append + (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>);</pre> <p> -Tests if a given GType is a struct, -i.e. it was created with <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a> +Finish appending elements to a given collection +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> +<td>a context created by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> +for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a collection</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="dbus-g-type-specialized-map-append"></a><h3>dbus_g_type_specialized_map_append ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_map_append (<em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>);</pre> +<p> +Inserts the given key/value pair into the map instance. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a GType to test</td> +<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> +<td>a context created by <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> +for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a map</td> </tr> <tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>true if the given GType is a struct</td> +<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td> +<td>a GValue containing a key, whose contents will be stolen by <em class="parameter"><code>ctx</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td> +<td>a GValue containing a value, whose contents will be stolen by <em class="parameter"><code>ctx</code></em> +</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-map-peek-vtable"></a><h3>dbus_g_type_map_peek_vtable ()</h3> -<pre class="programlisting">const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="returnvalue">DBusGTypeSpecializedMapVtable</span></a> * dbus_g_type_map_peek_vtable - (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> map_type</code></em>);</pre> +<a name="dbus-g-type-collection-get-fixed"></a><h3>dbus_g_type_collection_get_fixed ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_collection_get_fixed (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *data_ret</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *len_ret</code></em>);</pre> <p> -Peek the vtable for a given map specialization +Calling this function is likely to be a bad idea. Consider using +<a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-value-iterate" title="dbus_g_type_collection_value_iterate ()"><code class="function">dbus_g_type_collection_value_iterate()</code></a> instead. +</p> +<p> +On success, <em class="parameter"><code>data_ret</code></em> is a pointer to the underlying data in a collection +of fixed-length fundamental types. Knowledge of the underlying data model +of the collection is needed in order to use <em class="parameter"><code>data_ret</code></em> correctly. +</p> +<p> +It is an error to call this function on a specialized type that is not a +collection, or on a collection that does not have a <em class="parameter"><code>fixed_accessor</code></em> in its +<a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="type">DBusGTypeSpecializedCollectionVtable</span></a>. +</p> +<p> +Specialized <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a>s are the only types provided by dbus-glib that +can be used with this function; user-defined types might also work. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>map_type</code></em> :</span></p></td> -<td>a gtype of a map specialization</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a GValue containing a boxed specialized collection +that has a <em class="parameter"><code>fixed_accessor</code></em> in its vtable</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>data_ret</code></em> :</span></p></td> +<td>used to return a pointer to the fixed data, which must not be +modified (for instance, for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>, this would point +to an array of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>len_ret</code></em> :</span></p></td> +<td>used to return the length (counting collection elements, not +bytes: in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> containing one <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>, this would be 1)</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the vtable</td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-map-value-iterate"></a><h3>dbus_g_type_map_value_iterate ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_map_value_iterate (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, +<a name="dbus-g-type-collection-value-iterate"></a><h3>dbus_g_type_collection_value_iterate ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_collection_value_iterate + (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIterator" title="DBusGTypeSpecializedCollectionIterator ()"><span class="type">DBusGTypeSpecializedCollectionIterator</span></a> iterator</code></em>, <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p> -Calls the given function for each key/value pair of the map. -The function is passed two GValues containing the key/value pair and the given -<em class="parameter"><code>user_data</code></em> parameter. The map may not be modified while iterating over +Calls the given function for each element of the collection. +The function is passed a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing the element and the given +<em class="parameter"><code>user_data</code></em> parameter. The collection may not be modified while iterating over it. </p> <div class="variablelist"><table border="0"> @@ -1265,7 +1328,7 @@ it. <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> holding a specialized map</td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> holding a collection type.</td> </tr> <tr> <td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td> @@ -1281,149 +1344,168 @@ it. </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-register-collection"></a><h3>dbus_g_type_register_collection ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_register_collection (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, - <em class="parameter"><code>const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="type">DBusGTypeSpecializedCollectionVtable</span></a> *vtable</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>);</pre> +<a name="dbus-g-type-map-value-iterate"></a><h3>dbus_g_type_map_value_iterate ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_map_value_iterate (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIterator" title="DBusGTypeSpecializedMapIterator ()"><span class="type">DBusGTypeSpecializedMapIterator</span></a> iterator</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> <p> -Defines a new collection container. +Calls the given function for each key/value pair of the map. +The function is passed two GValues containing the key/value pair and the given +<em class="parameter"><code>user_data</code></em> parameter. The map may not be modified while iterating over +it. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> -<td>The name of a new collection container</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> holding a specialized map</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>vtable</code></em> :</span></p></td> -<td>the vtable defining the new container</td> +<td><p><span class="term"><em class="parameter"><code>iterator</code></em> :</span></p></td> +<td>a function to call for each element</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>As yet unused.</td> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data to pass to the <em class="parameter"><code>iterator</code></em> +</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-register-map"></a><h3>dbus_g_type_register_map ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_register_map (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, - <em class="parameter"><code>const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="type">DBusGTypeSpecializedMapVtable</span></a> *vtable</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>);</pre> +<a name="dbus-g-type-struct-get-member"></a><h3>dbus_g_type_struct_get_member ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_get_member (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>);</pre> <p> -Defines a new map container. +Fetches a given member of a given struct instance. <em class="parameter"><code>dest</code></em> must be initialised +was the correct type for that member, e.g. as returned by +<em class="parameter"><code>dbus_g_type_get_struct_member_type</code></em> </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> -<td>The name of a new map container</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>vtable</code></em> :</span></p></td> -<td>the vtable defining the new container</td> +<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> +<td>the index of a given member</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>As yet unused.</td> +<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td> +<td>an initialised <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> in which to return the struct member</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-register-struct"></a><h3>dbus_g_type_register_struct ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_register_struct (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, - <em class="parameter"><code>const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="type">DBusGTypeSpecializedStructVtable</span></a> *vtable</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>);</pre> +<a name="dbus-g-type-struct-set-member"></a><h3>dbus_g_type_struct_set_member ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_set_member (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>);</pre> <p> -Defines a new struct container. +Sets a given member of a struct to a new value. The type of <em class="parameter"><code>src</code></em> must match +the existing type of <em class="parameter"><code>member</code></em> member of the struct. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> -<td>The name of a new struct container</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>vtable</code></em> :</span></p></td> -<td>the vtable defining the new container</td> +<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> +<td>the index of a given member</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> -<td>As yet unused.</td> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>an <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing the new value for that struct member</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-specialized-collection-append"></a><h3>dbus_g_type_specialized_collection_append ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_collection_append - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *elt</code></em>);</pre> +<a name="dbus-g-type-struct-get"></a><h3>dbus_g_type_struct_get ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_get (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, + <em class="parameter"><code>...</code></em>);</pre> <p> -Appends a given element to the end of a collection. +Collects the selected values of this struct into the return locations +provided. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> -<td>a context created by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> -for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a collection</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>elt</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing an element to append to the collection</td> +<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> +<td>struct member to get</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>location in which to return the value of this member, +followed optionally by more member/return locations pairs, followed by +by <code class="literal">G_MAXUINT</code> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-specialized-collection-end-append"></a><h3>dbus_g_type_specialized_collection_end_append ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_collection_end_append - (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>);</pre> -<p> -Finish appending elements to a given collection -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> -<td>a context created by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> -for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a collection</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-g-type-specialized-construct"></a><h3>dbus_g_type_specialized_construct ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> dbus_g_type_specialized_construct (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> gtype</code></em>);</pre> +<a name="dbus-g-type-struct-set"></a><h3>dbus_g_type_struct_set ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_set (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, + <em class="parameter"><code>...</code></em>);</pre> <p> -Create an instance of a given specialized type. -The structure created and returned will depend on the container type of the -GType. E.g. If the given type was created by -dbus_g_type_get_collection("GArray", G_TYPE_INT), -then this will return a GArray with element_size of sizeof(int) +Sets the selected members of the struct in <em class="parameter"><code>value</code></em>. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>gtype</code></em> :</span></p></td> -<td>a specialized <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>, as created by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()"><code class="function">dbus_g_type_get_collection()</code></a>, -<a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a> or <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> +<td>struct member to set</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>value for the first member, followed optionally by +more member/value pairs, followed by <code class="literal">G_MAXUINT</code> </td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a pointer to a newly constructed instance of the given type.</td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure</td> </tr> </tbody> </table></div> @@ -1443,123 +1525,98 @@ automatically whenever necessary. </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-specialized-init-append"></a><h3>dbus_g_type_specialized_init_append ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_init_append (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>);</pre> +<a name="dbus-g-type-register-collection"></a><h3>dbus_g_type_register_collection ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_register_collection (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="type">DBusGTypeSpecializedCollectionVtable</span></a> *vtable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>);</pre> <p> -Create a new context for adding elements to a collection or key/value pairs -to a map. You generally don't need or want to use this.. +Defines a new collection container. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing an instance of specialized type</td> +<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> +<td>The name of a new collection container</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> -<td>a <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> in which to return a new appending context.</td> +<td><p><span class="term"><em class="parameter"><code>vtable</code></em> :</span></p></td> +<td>the vtable defining the new container</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> +<td>As yet unused.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-specialized-map-append"></a><h3>dbus_g_type_specialized_map_append ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_specialized_map_append (<em class="parameter"><code><a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext" title="DBusGTypeSpecializedAppendContext"><span class="type">DBusGTypeSpecializedAppendContext</span></a> *ctx</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *key</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *val</code></em>);</pre> +<a name="dbus-g-type-register-map"></a><h3>dbus_g_type_register_map ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_register_map (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="type">DBusGTypeSpecializedMapVtable</span></a> *vtable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>);</pre> <p> -Inserts the given key/value pair into the map instance. +Defines a new map container. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td> -<td>a context created by <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append" title="dbus_g_type_specialized_init_append ()"><code class="function">dbus_g_type_specialized_init_append()</code></a> -for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a map</td> +<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> +<td>The name of a new map container</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td> -<td>a GValue containing a key, whose contents will be stolen by <em class="parameter"><code>ctx</code></em> -</td> +<td><p><span class="term"><em class="parameter"><code>vtable</code></em> :</span></p></td> +<td>the vtable defining the new container</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td> -<td>a GValue containing a value, whose contents will be stolen by <em class="parameter"><code>ctx</code></em> -</td> +<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> +<td>As yet unused.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-struct-get"></a><h3>dbus_g_type_struct_get ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_get (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, - <em class="parameter"><code>...</code></em>);</pre> +<a name="dbus-g-type-map-peek-vtable"></a><h3>dbus_g_type_map_peek_vtable ()</h3> +<pre class="programlisting">const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapVtable" title="DBusGTypeSpecializedMapVtable"><span class="returnvalue">DBusGTypeSpecializedMapVtable</span></a> * dbus_g_type_map_peek_vtable + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> map_type</code></em>);</pre> <p> -Collects the selected values of this struct into the return locations -provided. +Peek the vtable for a given map specialization </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> -<td>struct member to get</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> -<td>location in which to return the value of this member, -followed optionally by more member/return locations pairs, followed by -by <code class="literal">G_MAXUINT</code> -</td> +<td><p><span class="term"><em class="parameter"><code>map_type</code></em> :</span></p></td> +<td>a gtype of a map specialization</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure</td> +<td>the vtable</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-struct-get-member"></a><h3>dbus_g_type_struct_get_member ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_get_member (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>);</pre> +<a name="dbus-g-type-collection-peek-vtable"></a><h3>dbus_g_type_collection_peek_vtable ()</h3> +<pre class="programlisting">const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable" title="DBusGTypeSpecializedCollectionVtable"><span class="returnvalue">DBusGTypeSpecializedCollectionVtable</span></a> * dbus_g_type_collection_peek_vtable + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> collection_type</code></em>);</pre> <p> -Fetches a given member of a given struct instance. <em class="parameter"><code>dest</code></em> must be initialised -was the correct type for that member, e.g. as returned by -<em class="parameter"><code>dbus_g_type_get_struct_member_type</code></em> +Peek the vtable for a given collection specialization </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> -<td>the index of a given member</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td> -<td>an initialised <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> in which to return the struct member</td> +<td><p><span class="term"><em class="parameter"><code>collection_type</code></em> :</span></p></td> +<td>a gtype of a collection specialization</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful</td> +<td>the vtable</td> </tr> </tbody> </table></div> @@ -1567,7 +1624,7 @@ was the correct type for that member, e.g. as returned by <hr> <div class="refsect2"> <a name="dbus-g-type-struct-peek-vtable"></a><h3>dbus_g_type_struct_peek_vtable ()</h3> -<pre class="programlisting">const <a class="link" href="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="returnvalue">DBusGTypeSpecializedStructVtable</span></a> * dbus_g_type_struct_peek_vtable +<pre class="programlisting">const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="returnvalue">DBusGTypeSpecializedStructVtable</span></a> * dbus_g_type_struct_peek_vtable (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> struct_type</code></em>);</pre> <p> Peek the vtable for a given struct specialization @@ -1588,100 +1645,252 @@ Peek the vtable for a given struct specialization </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-struct-set"></a><h3>dbus_g_type_struct_set ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_set (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, - <em class="parameter"><code>...</code></em>);</pre> +<a name="dbus-g-type-register-struct"></a><h3>dbus_g_type_register_struct ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_type_register_struct (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>, + <em class="parameter"><code>const <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructVtable" title="DBusGTypeSpecializedStructVtable"><span class="type">DBusGTypeSpecializedStructVtable</span></a> *vtable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>);</pre> <p> -Sets the selected members of the struct in <em class="parameter"><code>value</code></em>. +Defines a new struct container. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> -<td>struct member to set</td> +<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> +<td>The name of a new struct container</td> </tr> <tr> -<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> -<td>value for the first member, followed optionally by -more member/value pairs, followed by <code class="literal">G_MAXUINT</code> -</td> +<td><p><span class="term"><em class="parameter"><code>vtable</code></em> :</span></p></td> +<td>the vtable defining the new container</td> </tr> <tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure</td> +<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td> +<td>As yet unused.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-type-struct-set-member"></a><h3>dbus_g_type_struct_set_member ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> dbus_g_type_struct_set_member (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> member</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>);</pre> +<a name="dbus-g-value-build-g-variant"></a><h3>dbus_g_value_build_g_variant ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * dbus_g_value_build_g_variant (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre> <p> -Sets a given member of a struct to a new value. The type of <em class="parameter"><code>src</code></em> must match -the existing type of <em class="parameter"><code>member</code></em> member of the struct. +Recurses <em class="parameter"><code>value</code></em> and converts its contents to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. +</p> +<p> +The value must either be a simple value (integer, string, boolean, +object path etc.) or a specialized container registered with +<a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()"><code class="function">dbus_g_type_get_collection()</code></a>, <a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a> or +<a class="link" href="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a>. Providing any other type is a programming error +(including as a child type). </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing a struct instance</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>member</code></em> :</span></p></td> -<td>the index of a given member</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> -<td>an <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing the new value for that struct member</td> +<td>a simple or specialized <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to convert to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> +</td> </tr> <tr> <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful</td> +<td>a new <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> containing <em class="parameter"><code>value</code></em> with a floating reference</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2"> -<a name="dbus-g-value-build-g-variant"></a><h3>dbus_g_value_build_g_variant ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * dbus_g_value_build_g_variant (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre> +<a name="dbus-g-value-parse-g-variant"></a><h3>dbus_g_value_parse_g_variant ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_value_parse_g_variant (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre> <p> -Recurses <em class="parameter"><code>value</code></em> and converts its contents to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. +Deserialize <em class="parameter"><code>variant</code></em> and put an equivalent dbus-glib data structure in +<em class="parameter"><code>value</code></em>. </p> <p> -The value must either be a simple value (integer, string, boolean, -object path etc.) or a specialized container registered with -<a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection" title="dbus_g_type_get_collection ()"><code class="function">dbus_g_type_get_collection()</code></a>, <a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map" title="dbus_g_type_get_map ()"><code class="function">dbus_g_type_get_map()</code></a> or -<a class="link" href="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct" title="dbus_g_type_get_struct ()"><code class="function">dbus_g_type_get_struct()</code></a>. Providing any other type is a programming error -(including as a child type). +It is an error if <em class="parameter"><code>variant</code></em> contains any <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> extensions not supported +by dbus-glib, including handles (file descriptor passing) and 'maybe' types. </p> <div class="variablelist"><table border="0"> <col align="left" valign="top"> <tbody> <tr> -<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> -<td>a simple or specialized <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to convert to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> +<td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> </td> </tr> <tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a new <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> containing <em class="parameter"><code>value</code></em> with a floating reference</td> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a zero-filled <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> +</td> </tr> </tbody> </table></div> </div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-BOOLEAN-ARRAY:CAPS"></a><h3>DBUS_TYPE_G_BOOLEAN_ARRAY</h3> +<pre class="programlisting">#define DBUS_TYPE_G_BOOLEAN_ARRAY (dbus_g_type_get_collection ("GArray", G_TYPE_BOOLEAN)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> +(corresponding to the D-Bus signature "ab"). +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-UCHAR-ARRAY:CAPS"></a><h3>DBUS_TYPE_G_UCHAR_ARRAY</h3> +<pre class="programlisting">#define DBUS_TYPE_G_UCHAR_ARRAY (dbus_g_type_get_collection ("GArray", G_TYPE_UCHAR)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> +(corresponding to the D-Bus signature "ay"). +</p> +<p> +Note that this is not the same thing as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray"><span class="type">GByteArray</span></a>! dbus-glib does not +know about the <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray"><span class="type">GByteArray</span></a> type. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-UINT-ARRAY:CAPS"></a><h3>DBUS_TYPE_G_UINT_ARRAY</h3> +<pre class="programlisting">#define DBUS_TYPE_G_UINT_ARRAY (dbus_g_type_get_collection ("GArray", G_TYPE_UINT)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> +(corresponding to the D-Bus signature "au"). +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-INT-ARRAY:CAPS"></a><h3>DBUS_TYPE_G_INT_ARRAY</h3> +<pre class="programlisting">#define DBUS_TYPE_G_INT_ARRAY (dbus_g_type_get_collection ("GArray", G_TYPE_INT)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> +(corresponding to the D-Bus signature "ai"). +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-UINT64-ARRAY:CAPS"></a><h3>DBUS_TYPE_G_UINT64_ARRAY</h3> +<pre class="programlisting">#define DBUS_TYPE_G_UINT64_ARRAY (dbus_g_type_get_collection ("GArray", G_TYPE_UINT64)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <span class="type">guint64</span> +(corresponding to the D-Bus signature "at"). +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-INT64-ARRAY:CAPS"></a><h3>DBUS_TYPE_G_INT64_ARRAY</h3> +<pre class="programlisting">#define DBUS_TYPE_G_INT64_ARRAY (dbus_g_type_get_collection ("GArray", G_TYPE_INT64)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <span class="type">gint64</span> +(corresponding to the D-Bus signature "ax"). +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-OBJECT-ARRAY:CAPS"></a><h3>DBUS_TYPE_G_OBJECT_ARRAY</h3> +<pre class="programlisting">#define DBUS_TYPE_G_OBJECT_ARRAY (dbus_g_type_get_collection ("GPtrArray", G_TYPE_OBJECT)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. +</p> +<p> +Use this type with caution: it can sometimes be used as a representation +of arrays whose D-Bus signature is "ao" (transferred as an array of object +paths), but the conventional type for such arrays is +<code class="literal">(dbus_g_type_get_collection ("GPtrArray", +DBUS_TYPE_G_OBJECT_PATH))</code>. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-STRING-STRING-HASHTABLE:CAPS"></a><h3>DBUS_TYPE_G_STRING_STRING_HASHTABLE</h3> +<pre class="programlisting">#define DBUS_TYPE_G_STRING_STRING_HASHTABLE (dbus_g_type_get_map ("GHashTable", G_TYPE_STRING, G_TYPE_STRING)) +</pre> +<p> +Expands to a function call returning the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> where the +keys are strings and the values are also strings (corresponding to the +D-Bus signature "a{ss}"). +</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBusGSignature"></a><h3>DBusGSignature</h3> +<pre class="programlisting">typedef gchar DBusGSignature; +</pre> +<p> +A typedef for a string used to represent D-Bus signatures. +Its GType is <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-SIGNATURE:CAPS" title="DBUS_TYPE_G_SIGNATURE"><code class="literal">DBUS_TYPE_G_SIGNATURE</code></a>, derived from <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a>. +</p> +<p> +Prior to version 0.FIXME this was used as the type name of +<a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-SIGNATURE:CAPS" title="DBUS_TYPE_G_SIGNATURE"><code class="literal">DBUS_TYPE_G_SIGNATURE</code></a>, but did not actually exist as a typedef. +</p> +<p class="since">Since 0.FIXME</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-SIGNATURE:CAPS"></a><h3>DBUS_TYPE_G_SIGNATURE</h3> +<pre class="programlisting">#define DBUS_TYPE_G_SIGNATURE (dbus_g_signature_get_g_type ()) +</pre> +<p> +The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGSignature" title="DBusGSignature"><span class="type">DBusGSignature</span></a>, which is a boxed type containing a +D-Bus signature as a zero-terminated string. Signatures can be +copied with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strdup"><code class="function">g_strdup()</code></a> and freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, just like <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>, +but have a distinct boxed type to allow them to be distinguished when +stored in a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a type derived from <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> +</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="DBusGObjectPath"></a><h3>DBusGObjectPath</h3> +<pre class="programlisting">typedef gchar DBusGObjectPath; +</pre> +<p> +A typedef for a string used to represent D-Bus object paths. +Its GType is <a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS" title="DBUS_TYPE_G_OBJECT_PATH"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a>, derived from <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a>. +</p> +<p> +Prior to version 0.FIXME this was used as the type name of +<a class="link" href="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS" title="DBUS_TYPE_G_OBJECT_PATH"><code class="literal">DBUS_TYPE_G_OBJECT_PATH</code></a>, but did not actually exist as a typedef. +</p> +<p class="since">Since 0.FIXME</p> +</div> +<hr> +<div class="refsect2"> +<a name="DBUS-TYPE-G-OBJECT-PATH:CAPS"></a><h3>DBUS_TYPE_G_OBJECT_PATH</h3> +<pre class="programlisting">#define DBUS_TYPE_G_OBJECT_PATH (dbus_g_object_path_get_g_type ()) +</pre> +<p> +The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of a <a class="link" href="dbus-glib-Specializable-GType-System.html#DBusGObjectPath" title="DBusGObjectPath"><span class="type">DBusGObjectPath</span></a>, which is a boxed type containing a +D-Bus object path as a zero-terminated string. Object paths can be +copied with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strdup"><code class="function">g_strdup()</code></a> and freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, just like <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a>, +but have a distinct boxed type to allow them to be distinguished when +stored in a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. +</p> +<div class="variablelist"><table border="0"> +<col align="left" valign="top"> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a type derived from <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a> +</td> +</tr></tbody> +</table></div> +</div> </div> </div> <div class="footer"> diff --git a/doc/reference/html/dbus-glib-dbus-glib-lowlevel.html b/doc/reference/html/dbus-glib-dbus-glib-lowlevel.html deleted file mode 100644 index 6bfc7fa..0000000 --- a/doc/reference/html/dbus-glib-dbus-glib-lowlevel.html +++ /dev/null @@ -1,436 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>DBus GLib low level</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> -<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual"> -<link rel="up" href="ch02.html" title="API Reference"> -<link rel="prev" href="dbus-glib-dbus-gtype-specialized.html" title="Specializable GType System"> -<link rel="next" href="ch03.html" title="Tools Reference"> -<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> -<tr valign="middle"> -<td><a accesskey="p" href="dbus-glib-dbus-gtype-specialized.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> -<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> -<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th> -<td><a accesskey="n" href="ch03.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#dbus-glib-dbus-glib-lowlevel.synopsis" class="shortcut">Top</a> -  | - <a href="#dbus-glib-dbus-glib-lowlevel.description" class="shortcut">Description</a> -</td></tr> -</table> -<div class="refentry"> -<a name="dbus-glib-dbus-glib-lowlevel"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="dbus-glib-dbus-glib-lowlevel.top_of_page"></a>DBus GLib low level</span></h2> -<p>DBus GLib low level — DBus lower level functions</p> -</td> -<td valign="top" align="right"></td> -</tr></table></div> -<div class="refsect1"> -<a name="dbus-glib-dbus-glib-lowlevel.stability-level"></a><h2>Stability Level</h2> -Unstable, unless otherwise indicated -</div> -<div class="refsynopsisdiv"> -<a name="dbus-glib-dbus-glib-lowlevel.synopsis"></a><h2>Synopsis</h2> -<pre class="synopsis">#define <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#DBUS-TYPE-CONNECTION:CAPS" title="DBUS_TYPE_CONNECTION">DBUS_TYPE_CONNECTION</a> -#define <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#DBUS-TYPE-MESSAGE:CAPS" title="DBUS_TYPE_MESSAGE">DBUS_TYPE_MESSAGE</a> -<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-connection-get-g-connection" title="dbus_connection_get_g_connection ()">dbus_connection_get_g_connection</a> (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-connection-get-g-type" title="dbus_connection_get_g_type ()">dbus_connection_get_g_type</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-connection-setup-with-g-main" title="dbus_connection_setup_with_g_main ()">dbus_connection_setup_with_g_main</a> (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>); -<span class="returnvalue">DBusConnection</span> * <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-g-connection-get-connection" title="dbus_g_connection_get_connection ()">dbus_g_connection_get_connection</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="type">DBusGConnection</span></a> *gconnection</code></em>); -<span class="returnvalue">DBusMessage</span> * <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-g-message-get-message" title="dbus_g_message_get_message ()">dbus_g_message_get_message</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMessage.html#DBusGMessage"><span class="type">DBusGMessage</span></a> *gmessage</code></em>); -<span class="returnvalue">DBusMessage</span> * <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-get-reply" title="dbus_g_method_get_reply ()">dbus_g_method_get_reply</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-get-sender" title="dbus_g_method_get_sender ()">dbus_g_method_get_sender</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-send-reply" title="dbus_g_method_send_reply ()">dbus_g_method_send_reply</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, - <em class="parameter"><code><span class="type">DBusMessage</span> *reply</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-g-proxy-send" title="dbus_g_proxy_send ()">dbus_g_proxy_send</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGProxy.html#DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, - <em class="parameter"><code><span class="type">DBusMessage</span> *message</code></em>, - <em class="parameter"><code><span class="type">dbus_uint32_t</span> *client_serial</code></em>); -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-message-get-g-type" title="dbus_message_get_g_type ()">dbus_message_get_g_type</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-server-setup-with-g-main" title="dbus_server_setup_with_g_main ()">dbus_server_setup_with_g_main</a> (<em class="parameter"><code><span class="type">DBusServer</span> *server</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>); -<span class="returnvalue">void</span> <a class="link" href="dbus-glib-dbus-glib-lowlevel.html#dbus-set-g-error" title="dbus_set_g_error ()">dbus_set_g_error</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **gerror</code></em>, - <em class="parameter"><code><span class="type">DBusError</span> *derror</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="dbus-glib-dbus-glib-lowlevel.description"></a><h2>Description</h2> -<p> -These functions can be used to access lower level of DBus. -</p> -</div> -<div class="refsect1"> -<a name="dbus-glib-dbus-glib-lowlevel.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="DBUS-TYPE-CONNECTION:CAPS"></a><h3>DBUS_TYPE_CONNECTION</h3> -<pre class="programlisting">#define DBUS_TYPE_CONNECTION (dbus_connection_get_g_type ()) -</pre> -<p> -Expands to a function call returning a boxed <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> representing a -<span class="type">DBusConnection</span> pointer from libdbus. Not to be confused with -<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBUS-TYPE-G-CONNECTION:CAPS"><code class="literal">DBUS_TYPE_G_CONNECTION</code></a>, which you should usually use instead. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the GLib type</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="DBUS-TYPE-MESSAGE:CAPS"></a><h3>DBUS_TYPE_MESSAGE</h3> -<pre class="programlisting">#define DBUS_TYPE_MESSAGE (dbus_message_get_g_type ()) -</pre> -<p> -Expands to a function call returning a boxed <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> representing a -<span class="type">DBusMessage</span> pointer from libdbus. Not to be confused with -<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMessage.html#DBUS-TYPE-G-MESSAGE:CAPS"><code class="literal">DBUS_TYPE_G_MESSAGE</code></a>, which you should usually use instead. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the GLib type</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-connection-get-g-connection"></a><h3>dbus_connection_get_g_connection ()</h3> -<pre class="programlisting"><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="returnvalue">DBusGConnection</span></a> * dbus_connection_get_g_connection (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>);</pre> -<p> -Get the <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="type">DBusGConnection</span></a> corresponding to this <span class="type">DBusConnection</span>. This only -makes sense if the <span class="type">DBusConnection</span> was originally a <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="type">DBusGConnection</span></a> that was -registered with the GLib main loop. The return value does not have its -refcount incremented. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> -<td>a <span class="type">DBusConnection</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="type">DBusGConnection</span></a></td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-connection-get-g-type"></a><h3>dbus_connection_get_g_type ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_connection_get_g_type (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p> -</p> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-connection-setup-with-g-main"></a><h3>dbus_connection_setup_with_g_main ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_connection_setup_with_g_main (<em class="parameter"><code><span class="type">DBusConnection</span> *connection</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>);</pre> -<p> -Sets the watch and timeout functions of a <span class="type">DBusConnection</span> -to integrate the connection with the GLib main loop. -Pass in <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> unless you're -doing something specialized. -</p> -<p> -If called twice for the same context, does nothing the second -time. If called once with context A and once with context B, -context B replaces context A as the context monitoring the -connection. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td> -<td>the connection</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for default context</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-g-connection-get-connection"></a><h3>dbus_g_connection_get_connection ()</h3> -<pre class="programlisting"><span class="returnvalue">DBusConnection</span> * dbus_g_connection_get_connection (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="type">DBusGConnection</span></a> *gconnection</code></em>);</pre> -<p> -Get the <span class="type">DBusConnection</span> corresponding to this <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="type">DBusGConnection</span></a>. -The return value does not have its refcount incremented. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>gconnection</code></em> :</span></p></td> -<td>a <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"><span class="type">DBusGConnection</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td><span class="type">DBusConnection</span></td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-g-message-get-message"></a><h3>dbus_g_message_get_message ()</h3> -<pre class="programlisting"><span class="returnvalue">DBusMessage</span> * dbus_g_message_get_message (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMessage.html#DBusGMessage"><span class="type">DBusGMessage</span></a> *gmessage</code></em>);</pre> -<p> -Get the <span class="type">DBusMessage</span> corresponding to this <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMessage.html#DBusGMessage"><span class="type">DBusGMessage</span></a>. -The return value does not have its refcount incremented. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>gmessage</code></em> :</span></p></td> -<td>a <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMessage.html#DBusGMessage"><span class="type">DBusGMessage</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td><span class="type">DBusMessage</span></td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-g-method-get-reply"></a><h3>dbus_g_method_get_reply ()</h3> -<pre class="programlisting"><span class="returnvalue">DBusMessage</span> * dbus_g_method_get_reply (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre> -<p> -Get the reply message to append reply values -Used as a sidedoor when you can't generate dbus values -of the correct type due to glib binding limitations -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the method context</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a <span class="type">DBusMessage</span> with the reply</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-g-method-get-sender"></a><h3>dbus_g_method_get_sender ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * dbus_g_method_get_sender (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>);</pre> -<p> -Get the sender of a message so we can send a -"reply" later (i.e. send a message directly -to a service which invoked the method at a -later time). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the method context</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the unique name of the sender. It -is up to the caller to free the returned string.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-g-method-send-reply"></a><h3>dbus_g_method_send_reply ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_method_send_reply (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> *context</code></em>, - <em class="parameter"><code><span class="type">DBusMessage</span> *reply</code></em>);</pre> -<p> -Send a manually created reply message. -</p> -<p> -Used as a sidedoor when you can't generate dbus values -of the correct type due to glib binding limitations -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the method context</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>reply</code></em> :</span></p></td> -<td>the reply message, will be unreffed</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-g-proxy-send"></a><h3>dbus_g_proxy_send ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_g_proxy_send (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGProxy.html#DBusGProxy"><span class="type">DBusGProxy</span></a> *proxy</code></em>, - <em class="parameter"><code><span class="type">DBusMessage</span> *message</code></em>, - <em class="parameter"><code><span class="type">dbus_uint32_t</span> *client_serial</code></em>);</pre> -<p> -Sends a message to the interface we're proxying for. Does not -block or wait for a reply. The message is only actually written out -when you return to the main loop or block in -<a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-flush"><code class="function">dbus_g_connection_flush()</code></a>. -</p> -<p> -The message is modified to be addressed to the target interface. -That is, a destination name field or whatever is needed will be -added to the message. The basic point of this function is to add -the necessary header fields, otherwise it's equivalent to -<code class="function">dbus_connection_send()</code>. -</p> -<p> -This function adds a reference to the message, so the caller -still owns its original reference. -</p> -<p> -It is an error to call this method on a proxy that has emitted -the <span class="type">"destroy"</span> signal. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td> -<td>a proxy for a remote interface</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td> -<td>the message to address and send</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>client_serial</code></em> :</span></p></td> -<td>return location for message's serial, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-message-get-g-type"></a><h3>dbus_message_get_g_type ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> dbus_message_get_g_type (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p> -</p> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-server-setup-with-g-main"></a><h3>dbus_server_setup_with_g_main ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_server_setup_with_g_main (<em class="parameter"><code><span class="type">DBusServer</span> *server</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>);</pre> -<p> -Sets the watch and timeout functions of a <span class="type">DBusServer</span> -to integrate the server with the GLib main loop. -In most cases the context argument should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -</p> -<p> -If called twice for the same context, does nothing the second -time. If called once with context A and once with context B, -context B replaces context A as the context monitoring the -connection. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>server</code></em> :</span></p></td> -<td>the server</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td> -<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for default</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="dbus-set-g-error"></a><h3>dbus_set_g_error ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> dbus_set_g_error (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **gerror</code></em>, - <em class="parameter"><code><span class="type">DBusError</span> *derror</code></em>);</pre> -<p> -Store the information from a DBus method error return into a -GError. For the normal case of an arbitrary remote process, -the error code will be DBUS_GERROR_REMOTE_EXCEPTION. Now, -DBus errors have two components; a message and a "name". -The former is an arbitrary (normally American English) string. -The second is a string like com.example.FooFailure which -programs can use as a conditional source. Because a GError -only has one string, we use a hack to encode both values: -</p> -<p> -<human readable string><null><error name><null> -</p> -<p> -You can use the following code to retrieve both values: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">const char</span> <span class="gtkdoc opt">*</span>msg <span class="gtkdoc opt">=</span> error<span class="gtkdoc opt">-></span>message<span class="gtkdoc opt">;</span> -<span class="gtkdoc kwb">size_t</span> len <span class="gtkdoc opt">=</span> <span class="function">strlen</span><span class="gtkdoc opt">(</span>msg<span class="gtkdoc opt">);</span> -<span class="gtkdoc kwb">const char</span> <span class="gtkdoc opt">*</span>error_name <span class="gtkdoc opt">=</span> msg<span class="gtkdoc opt">+</span>len<span class="gtkdoc opt">+</span><span class="number">1</span><span class="gtkdoc opt">;</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>gerror</code></em> :</span></p></td> -<td>an error</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>derror</code></em> :</span></p></td> -<td>a <span class="type">DBusError</span> -</td> -</tr> -</tbody> -</table></div> -</div> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18</div> -</body> -</html>
\ No newline at end of file diff --git a/doc/reference/html/dbus-glib.devhelp2 b/doc/reference/html/dbus-glib.devhelp2 index 110d334..aed7f5c 100644 --- a/doc/reference/html/dbus-glib.devhelp2 +++ b/doc/reference/html/dbus-glib.devhelp2 @@ -5,78 +5,149 @@ <sub name="Introduction" link="ch01.html"/> <sub name="API Reference" link="ch02.html"> <sub name="API for using D-BUS with GLib" link="ch02.html#api-overview"/> - <sub name="Specializable GType System" link="dbus-glib-dbus-gtype-specialized.html"/> - <sub name="DBus GLib low level" link="dbus-glib-dbus-glib-lowlevel.html"/> + <sub name="DBusGConnection" link="dbus-glib-DBusGConnection.html"/> + <sub name="DBus GObject related functions" link="dbus-glib-DBus-GObject-related-functions.html"/> + <sub name="DBusGMessage" link="dbus-glib-DBusGMessage.html"/> + <sub name="DBusGMethod" link="dbus-glib-DBusGMethod.html"/> + <sub name="DBusGError" link="dbus-glib-DBusGError.html"/> + <sub name="DBusGProxy" link="dbus-glib-DBusGProxy.html"/> + <sub name="Specializable GType System" link="dbus-glib-Specializable-GType-System.html"/> + <sub name="DBus GLib low level" link="dbus-glib-DBus-GLib-low-level.html"/> </sub> <sub name="Tools Reference" link="ch03.html"> <sub name="dbus-binding-tool" link="dbus-binding-tool.html"/> </sub> </chapters> <functions> - <keyword type="struct" name="DBusGTypeSpecializedAppendContext" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext"/> - <keyword type="function" name="DBusGTypeSpecializedCollectionAppendFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionAppendFunc"/> - <keyword type="function" name="DBusGTypeSpecializedCollectionEndAppendFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionEndAppendFunc"/> - <keyword type="function" name="DBusGTypeSpecializedCollectionFixedAccessorFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionFixedAccessorFunc"/> - <keyword type="function" name="DBusGTypeSpecializedCollectionIterator ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIterator"/> - <keyword type="function" name="DBusGTypeSpecializedCollectionIteratorFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIteratorFunc"/> - <keyword type="struct" name="DBusGTypeSpecializedCollectionVtable" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable"/> - <keyword type="function" name="DBusGTypeSpecializedConstructor ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedConstructor"/> - <keyword type="function" name="DBusGTypeSpecializedCopyFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCopyFunc"/> - <keyword type="function" name="DBusGTypeSpecializedFreeFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedFreeFunc"/> - <keyword type="function" name="DBusGTypeSpecializedMapAppendFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapAppendFunc"/> - <keyword type="function" name="DBusGTypeSpecializedMapIterator ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIterator"/> - <keyword type="function" name="DBusGTypeSpecializedMapIteratorFunc ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIteratorFunc"/> - <keyword type="struct" name="DBusGTypeSpecializedMapVtable" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapVtable"/> - <keyword type="function" name="DBusGTypeSpecializedStructGetMember ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructGetMember"/> - <keyword type="function" name="DBusGTypeSpecializedStructSetMember ()" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructSetMember"/> - <keyword type="struct" name="DBusGTypeSpecializedStructVtable" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructVtable"/> - <keyword type="struct" name="DBusGTypeSpecializedVtable" link="dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedVtable"/> - <keyword type="function" name="dbus_g_type_collection_get_fixed ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-get-fixed"/> - <keyword type="function" name="dbus_g_type_collection_peek_vtable ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-peek-vtable"/> - <keyword type="function" name="dbus_g_type_collection_value_iterate ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-value-iterate"/> - <keyword type="function" name="dbus_g_type_get_collection ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection"/> - <keyword type="function" name="dbus_g_type_get_collection_specialization ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection-specialization"/> - <keyword type="function" name="dbus_g_type_get_map ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map"/> - <keyword type="function" name="dbus_g_type_get_map_key_specialization ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map-key-specialization"/> - <keyword type="function" name="dbus_g_type_get_map_value_specialization ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map-value-specialization"/> - <keyword type="function" name="dbus_g_type_get_struct ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct"/> - <keyword type="function" name="dbus_g_type_get_struct_member_type ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct-member-type"/> - <keyword type="function" name="dbus_g_type_get_struct_size ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct-size"/> - <keyword type="function" name="dbus_g_type_get_structv ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-structv"/> - <keyword type="function" name="dbus_g_type_is_collection ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-collection"/> - <keyword type="function" name="dbus_g_type_is_map ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-map"/> - <keyword type="function" name="dbus_g_type_is_struct ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-struct"/> - <keyword type="function" name="dbus_g_type_map_peek_vtable ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-peek-vtable"/> - <keyword type="function" name="dbus_g_type_map_value_iterate ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-value-iterate"/> - <keyword type="function" name="dbus_g_type_register_collection ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-collection"/> - <keyword type="function" name="dbus_g_type_register_map ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-map"/> - <keyword type="function" name="dbus_g_type_register_struct ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-struct"/> - <keyword type="function" name="dbus_g_type_specialized_collection_append ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-append"/> - <keyword type="function" name="dbus_g_type_specialized_collection_end_append ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-end-append"/> - <keyword type="function" name="dbus_g_type_specialized_construct ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-construct"/> - <keyword type="function" name="dbus_g_type_specialized_init ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init"/> - <keyword type="function" name="dbus_g_type_specialized_init_append ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append"/> - <keyword type="function" name="dbus_g_type_specialized_map_append ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-map-append"/> - <keyword type="function" name="dbus_g_type_struct_get ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-get"/> - <keyword type="function" name="dbus_g_type_struct_get_member ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-get-member"/> - <keyword type="function" name="dbus_g_type_struct_peek_vtable ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-peek-vtable"/> - <keyword type="function" name="dbus_g_type_struct_set ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-set"/> - <keyword type="function" name="dbus_g_type_struct_set_member ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-set-member"/> - <keyword type="function" name="dbus_g_value_build_g_variant ()" link="dbus-glib-dbus-gtype-specialized.html#dbus-g-value-build-g-variant"/> - <keyword type="macro" name="DBUS_TYPE_CONNECTION" link="dbus-glib-dbus-glib-lowlevel.html#DBUS-TYPE-CONNECTION:CAPS"/> - <keyword type="macro" name="DBUS_TYPE_MESSAGE" link="dbus-glib-dbus-glib-lowlevel.html#DBUS-TYPE-MESSAGE:CAPS"/> - <keyword type="function" name="dbus_connection_get_g_connection ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-connection-get-g-connection"/> - <keyword type="function" name="dbus_connection_get_g_type ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-connection-get-g-type"/> - <keyword type="function" name="dbus_connection_setup_with_g_main ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-connection-setup-with-g-main"/> - <keyword type="function" name="dbus_g_connection_get_connection ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-g-connection-get-connection"/> - <keyword type="function" name="dbus_g_message_get_message ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-g-message-get-message"/> - <keyword type="function" name="dbus_g_method_get_reply ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-get-reply"/> - <keyword type="function" name="dbus_g_method_get_sender ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-get-sender"/> - <keyword type="function" name="dbus_g_method_send_reply ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-send-reply"/> - <keyword type="function" name="dbus_g_proxy_send ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-g-proxy-send"/> - <keyword type="function" name="dbus_message_get_g_type ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-message-get-g-type"/> - <keyword type="function" name="dbus_server_setup_with_g_main ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-server-setup-with-g-main"/> - <keyword type="function" name="dbus_set_g_error ()" link="dbus-glib-dbus-glib-lowlevel.html#dbus-set-g-error"/> - <keyword type="" name="Options" link="dbus-binding-tool.html#idp5167568"/> + <keyword type="struct" name="DBusGConnection" link="dbus-glib-DBusGConnection.html#DBusGConnection"/> + <keyword type="macro" name="DBUS_TYPE_G_CONNECTION" link="dbus-glib-DBusGConnection.html#DBUS-TYPE-G-CONNECTION:CAPS"/> + <keyword type="function" name="dbus_g_bus_get ()" link="dbus-glib-DBusGConnection.html#dbus-g-bus-get"/> + <keyword type="function" name="dbus_g_bus_get_private ()" link="dbus-glib-DBusGConnection.html#dbus-g-bus-get-private"/> + <keyword type="function" name="dbus_g_thread_init ()" link="dbus-glib-DBusGConnection.html#dbus-g-thread-init"/> + <keyword type="function" name="dbus_g_connection_open ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-open"/> + <keyword type="function" name="dbus_g_connection_ref ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-ref"/> + <keyword type="function" name="dbus_g_connection_unref ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-unref"/> + <keyword type="function" name="dbus_g_connection_flush ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-flush"/> + <keyword type="function" name="dbus_g_connection_get_connection ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-get-connection"/> + <keyword type="function" name="dbus_g_connection_register_g_object ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-register-g-object"/> + <keyword type="function" name="dbus_g_connection_unregister_g_object ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-unregister-g-object"/> + <keyword type="function" name="dbus_g_connection_lookup_g_object ()" link="dbus-glib-DBusGConnection.html#dbus-g-connection-lookup-g-object"/> + <keyword type="struct" name="struct DBusGObjectInfo" link="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo"/> + <keyword type="function" name="dbus_g_object_type_install_info ()" link="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-install-info"/> + <keyword type="function" name="dbus_g_object_type_register_shadow_property ()" link="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-register-shadow-property"/> + <keyword type="function" name="dbus_g_object_path_get_g_type ()" link="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-path-get-g-type"/> + <keyword type="function" name="dbus_g_object_register_marshaller ()" link="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller"/> + <keyword type="function" name="dbus_g_object_register_marshaller_array ()" link="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller-array"/> + <keyword type="function" name="dbus_glib_global_set_disable_legacy_property_access ()" link="dbus-glib-DBus-GObject-related-functions.html#dbus-glib-global-set-disable-legacy-property-access" since="0.88"/> + <keyword type="struct" name="DBusGMessage" link="dbus-glib-DBusGMessage.html#DBusGMessage"/> + <keyword type="macro" name="DBUS_TYPE_G_MESSAGE" link="dbus-glib-DBusGMessage.html#DBUS-TYPE-G-MESSAGE:CAPS"/> + <keyword type="function" name="dbus_g_message_ref ()" link="dbus-glib-DBusGMessage.html#dbus-g-message-ref"/> + <keyword type="function" name="dbus_g_message_unref ()" link="dbus-glib-DBusGMessage.html#dbus-g-message-unref"/> + <keyword type="function" name="dbus_g_message_get_message ()" link="dbus-glib-DBusGMessage.html#dbus-g-message-get-message"/> + <keyword type="struct" name="struct DBusGMethodInfo" link="dbus-glib-DBusGMethod.html#DBusGMethodInfo"/> + <keyword type="struct" name="DBusGMethodInvocation" link="dbus-glib-DBusGMethod.html#DBusGMethodInvocation"/> + <keyword type="function" name="dbus_g_method_get_sender ()" link="dbus-glib-DBusGMethod.html#dbus-g-method-get-sender"/> + <keyword type="function" name="dbus_g_method_get_reply ()" link="dbus-glib-DBusGMethod.html#dbus-g-method-get-reply"/> + <keyword type="function" name="dbus_g_method_send_reply ()" link="dbus-glib-DBusGMethod.html#dbus-g-method-send-reply"/> + <keyword type="function" name="dbus_g_method_return ()" link="dbus-glib-DBusGMethod.html#dbus-g-method-return"/> + <keyword type="function" name="dbus_g_method_return_error ()" link="dbus-glib-DBusGMethod.html#dbus-g-method-return-error"/> + <keyword type="enum" name="enum DBusGError" link="dbus-glib-DBusGError.html#DBusGError"/> + <keyword type="function" name="dbus_g_error_has_name ()" link="dbus-glib-DBusGError.html#dbus-g-error-has-name"/> + <keyword type="function" name="dbus_g_error_get_name ()" link="dbus-glib-DBusGError.html#dbus-g-error-get-name"/> + <keyword type="function" name="dbus_g_error_domain_register ()" link="dbus-glib-DBusGError.html#dbus-g-error-domain-register"/> + <keyword type="macro" name="DBUS_GERROR" link="dbus-glib-DBusGError.html#DBUS-GERROR:CAPS"/> + <keyword type="struct" name="struct DBusGProxy" link="dbus-glib-DBusGProxy.html#DBusGProxy"/> + <keyword type="struct" name="DBusGProxyCall" link="dbus-glib-DBusGProxy.html#DBusGProxyCall"/> + <keyword type="function" name="DBusGProxyCallNotify ()" link="dbus-glib-DBusGProxy.html#DBusGProxyCallNotify"/> + <keyword type="function" name="dbus_g_proxy_new_for_name ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name"/> + <keyword type="function" name="dbus_g_proxy_new_for_name_owner ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner"/> + <keyword type="function" name="dbus_g_proxy_new_from_proxy ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-from-proxy"/> + <keyword type="function" name="dbus_g_proxy_new_for_peer ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-peer"/> + <keyword type="function" name="dbus_g_proxy_set_interface ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-set-interface"/> + <keyword type="function" name="dbus_g_proxy_get_path ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-get-path"/> + <keyword type="function" name="dbus_g_proxy_get_bus_name ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-get-bus-name"/> + <keyword type="function" name="dbus_g_proxy_get_interface ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-get-interface"/> + <keyword type="function" name="dbus_g_proxy_add_signal ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-add-signal"/> + <keyword type="function" name="dbus_g_proxy_connect_signal ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-connect-signal"/> + <keyword type="function" name="dbus_g_proxy_disconnect_signal ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-disconnect-signal"/> + <keyword type="function" name="dbus_g_proxy_send ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-send"/> + <keyword type="function" name="dbus_g_proxy_call ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-call"/> + <keyword type="function" name="dbus_g_proxy_call_with_timeout ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-call-with-timeout"/> + <keyword type="function" name="dbus_g_proxy_call_no_reply ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-call-no-reply"/> + <keyword type="function" name="dbus_g_proxy_begin_call ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call"/> + <keyword type="function" name="dbus_g_proxy_begin_call_with_timeout ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call-with-timeout"/> + <keyword type="function" name="dbus_g_proxy_end_call ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call"/> + <keyword type="function" name="dbus_g_proxy_cancel_call ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-cancel-call"/> + <keyword type="function" name="dbus_g_proxy_set_default_timeout ()" link="dbus-glib-DBusGProxy.html#dbus-g-proxy-set-default-timeout" since="0.75"/> + <keyword type="function" name="DBusGTypeSpecializedCollectionIterator ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIterator"/> + <keyword type="function" name="DBusGTypeSpecializedMapIterator ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIterator"/> + <keyword type="struct" name="DBusGTypeSpecializedAppendContext" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext"/> + <keyword type="function" name="DBusGTypeSpecializedConstructor ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedConstructor"/> + <keyword type="function" name="DBusGTypeSpecializedFreeFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedFreeFunc"/> + <keyword type="function" name="DBusGTypeSpecializedCopyFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCopyFunc"/> + <keyword type="struct" name="DBusGTypeSpecializedVtable" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedVtable"/> + <keyword type="function" name="DBusGTypeSpecializedCollectionFixedAccessorFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionFixedAccessorFunc"/> + <keyword type="function" name="DBusGTypeSpecializedCollectionIteratorFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIteratorFunc"/> + <keyword type="function" name="DBusGTypeSpecializedCollectionAppendFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionAppendFunc"/> + <keyword type="function" name="DBusGTypeSpecializedCollectionEndAppendFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionEndAppendFunc"/> + <keyword type="struct" name="DBusGTypeSpecializedCollectionVtable" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable"/> + <keyword type="function" name="DBusGTypeSpecializedMapIteratorFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIteratorFunc"/> + <keyword type="function" name="DBusGTypeSpecializedMapAppendFunc ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapAppendFunc"/> + <keyword type="struct" name="DBusGTypeSpecializedMapVtable" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapVtable"/> + <keyword type="function" name="DBusGTypeSpecializedStructGetMember ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructGetMember"/> + <keyword type="function" name="DBusGTypeSpecializedStructSetMember ()" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructSetMember"/> + <keyword type="struct" name="DBusGTypeSpecializedStructVtable" link="dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructVtable"/> + <keyword type="function" name="dbus_g_type_get_collection ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection"/> + <keyword type="function" name="dbus_g_type_get_map ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map"/> + <keyword type="function" name="dbus_g_type_get_structv ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-structv"/> + <keyword type="function" name="dbus_g_type_get_struct ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct"/> + <keyword type="function" name="dbus_g_type_is_collection ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-is-collection"/> + <keyword type="function" name="dbus_g_type_is_map ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-is-map"/> + <keyword type="function" name="dbus_g_type_is_struct ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-is-struct"/> + <keyword type="function" name="dbus_g_type_get_collection_specialization ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection-specialization"/> + <keyword type="function" name="dbus_g_type_get_map_key_specialization ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map-key-specialization"/> + <keyword type="function" name="dbus_g_type_get_map_value_specialization ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map-value-specialization"/> + <keyword type="function" name="dbus_g_type_get_struct_member_type ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct-member-type"/> + <keyword type="function" name="dbus_g_type_get_struct_size ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct-size"/> + <keyword type="function" name="dbus_g_type_specialized_construct ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-construct"/> + <keyword type="function" name="dbus_g_type_specialized_init_append ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append"/> + <keyword type="function" name="dbus_g_type_specialized_collection_append ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-append"/> + <keyword type="function" name="dbus_g_type_specialized_collection_end_append ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-end-append"/> + <keyword type="function" name="dbus_g_type_specialized_map_append ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-map-append"/> + <keyword type="function" name="dbus_g_type_collection_get_fixed ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-get-fixed"/> + <keyword type="function" name="dbus_g_type_collection_value_iterate ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-value-iterate"/> + <keyword type="function" name="dbus_g_type_map_value_iterate ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-map-value-iterate"/> + <keyword type="function" name="dbus_g_type_struct_get_member ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-get-member"/> + <keyword type="function" name="dbus_g_type_struct_set_member ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-set-member"/> + <keyword type="function" name="dbus_g_type_struct_get ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-get"/> + <keyword type="function" name="dbus_g_type_struct_set ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-set"/> + <keyword type="function" name="dbus_g_type_specialized_init ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init"/> + <keyword type="function" name="dbus_g_type_register_collection ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-register-collection"/> + <keyword type="function" name="dbus_g_type_register_map ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-register-map"/> + <keyword type="function" name="dbus_g_type_map_peek_vtable ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-map-peek-vtable"/> + <keyword type="function" name="dbus_g_type_collection_peek_vtable ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-peek-vtable"/> + <keyword type="function" name="dbus_g_type_struct_peek_vtable ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-peek-vtable"/> + <keyword type="function" name="dbus_g_type_register_struct ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-type-register-struct"/> + <keyword type="function" name="dbus_g_value_build_g_variant ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-value-build-g-variant"/> + <keyword type="function" name="dbus_g_value_parse_g_variant ()" link="dbus-glib-Specializable-GType-System.html#dbus-g-value-parse-g-variant"/> + <keyword type="macro" name="DBUS_TYPE_G_BOOLEAN_ARRAY" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-BOOLEAN-ARRAY:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_G_UCHAR_ARRAY" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UCHAR-ARRAY:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_G_UINT_ARRAY" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UINT-ARRAY:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_G_INT_ARRAY" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-INT-ARRAY:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_G_UINT64_ARRAY" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UINT64-ARRAY:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_G_INT64_ARRAY" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-INT64-ARRAY:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_G_OBJECT_ARRAY" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-ARRAY:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_G_STRING_STRING_HASHTABLE" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-STRING-STRING-HASHTABLE:CAPS"/> + <keyword type="typedef" name="DBusGSignature" link="dbus-glib-Specializable-GType-System.html#DBusGSignature" since="0.FIXME"/> + <keyword type="macro" name="DBUS_TYPE_G_SIGNATURE" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-SIGNATURE:CAPS"/> + <keyword type="typedef" name="DBusGObjectPath" link="dbus-glib-Specializable-GType-System.html#DBusGObjectPath" since="0.FIXME"/> + <keyword type="macro" name="DBUS_TYPE_G_OBJECT_PATH" link="dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"/> + <keyword type="function" name="dbus_set_g_error ()" link="dbus-glib-DBus-GLib-low-level.html#dbus-set-g-error"/> + <keyword type="function" name="dbus_connection_setup_with_g_main ()" link="dbus-glib-DBus-GLib-low-level.html#dbus-connection-setup-with-g-main"/> + <keyword type="function" name="dbus_connection_get_g_connection ()" link="dbus-glib-DBus-GLib-low-level.html#dbus-connection-get-g-connection"/> + <keyword type="function" name="dbus_server_setup_with_g_main ()" link="dbus-glib-DBus-GLib-low-level.html#dbus-server-setup-with-g-main"/> + <keyword type="macro" name="DBUS_TYPE_CONNECTION" link="dbus-glib-DBus-GLib-low-level.html#DBUS-TYPE-CONNECTION:CAPS"/> + <keyword type="macro" name="DBUS_TYPE_MESSAGE" link="dbus-glib-DBus-GLib-low-level.html#DBUS-TYPE-MESSAGE:CAPS"/> + <keyword type="" name="Options" link="dbus-binding-tool.html#idp4772416"/> </functions> </book> diff --git a/doc/reference/html/index.html b/doc/reference/html/index.html index c6f051e..2c8330c 100644 --- a/doc/reference/html/index.html +++ b/doc/reference/html/index.html @@ -14,7 +14,7 @@ <div class="titlepage"> <div> <div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">D-Bus GLib bindings - Reference Manual</p></th></tr></table></div> -<div><p class="releaseinfo">for version 0.100 +<div><p class="releaseinfo">for version 0.100.2 </p></div> </div> <hr> @@ -25,10 +25,28 @@ <dd><dl> <dt><span class="sect1"><a href="ch02.html#api-overview">API for using D-BUS with GLib</a></span></dt> <dt> -<span class="refentrytitle"><a href="dbus-glib-dbus-gtype-specialized.html">Specializable GType System</a></span><span class="refpurpose"> — Specialized GTypes</span> +<span class="refentrytitle"><a href="dbus-glib-DBusGConnection.html">DBusGConnection</a></span><span class="refpurpose"> — DBus Connection</span> </dt> <dt> -<span class="refentrytitle"><a href="dbus-glib-dbus-glib-lowlevel.html">DBus GLib low level</a></span><span class="refpurpose"> — DBus lower level functions</span> +<span class="refentrytitle"><a href="dbus-glib-DBus-GObject-related-functions.html">DBus GObject related functions</a></span><span class="refpurpose"> — Exporting a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> remotely</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGMessage.html">DBusGMessage</a></span><span class="refpurpose"> — DBus Message</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGMethod.html">DBusGMethod</a></span><span class="refpurpose"> — GMethod Info & Invocation</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGError.html">DBusGError</a></span><span class="refpurpose"> — DBus GError</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBusGProxy.html">DBusGProxy</a></span><span class="refpurpose"> — DBus Proxy</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-Specializable-GType-System.html">Specializable GType System</a></span><span class="refpurpose"> — Specialized GTypes</span> +</dt> +<dt> +<span class="refentrytitle"><a href="dbus-glib-DBus-GLib-low-level.html">DBus GLib low level</a></span><span class="refpurpose"> — DBus lower level functions</span> </dt> </dl></dd> <dt><span class="chapter"><a href="ch03.html">Tools Reference</a></span></dt> diff --git a/doc/reference/html/index.sgml b/doc/reference/html/index.sgml index 6042bb1..5626012 100644 --- a/doc/reference/html/index.sgml +++ b/doc/reference/html/index.sgml @@ -1,75 +1,176 @@ -<ANCHOR id="dbus-glib-dbus-gtype-specialized" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html"> -<ANCHOR id="dbus-glib-dbus-gtype-specialized.stability-level" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-glib-dbus-gtype-specialized.stability-level"> -<ANCHOR id="dbus-glib-dbus-gtype-specialized.synopsis" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-glib-dbus-gtype-specialized.synopsis"> -<ANCHOR id="dbus-glib-dbus-gtype-specialized.description" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-glib-dbus-gtype-specialized.description"> -<ANCHOR id="dbus-glib-dbus-gtype-specialized.details" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-glib-dbus-gtype-specialized.details"> -<ANCHOR id="DBusGTypeSpecializedAppendContext" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedAppendContext"> -<ANCHOR id="DBusGTypeSpecializedCollectionAppendFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionAppendFunc"> -<ANCHOR id="DBusGTypeSpecializedCollectionEndAppendFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionEndAppendFunc"> -<ANCHOR id="DBusGTypeSpecializedCollectionFixedAccessorFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionFixedAccessorFunc"> -<ANCHOR id="DBusGTypeSpecializedCollectionIterator" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIterator"> -<ANCHOR id="DBusGTypeSpecializedCollectionIteratorFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionIteratorFunc"> -<ANCHOR id="DBusGTypeSpecializedCollectionVtable" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCollectionVtable"> -<ANCHOR id="DBusGTypeSpecializedConstructor" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedConstructor"> -<ANCHOR id="DBusGTypeSpecializedCopyFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedCopyFunc"> -<ANCHOR id="DBusGTypeSpecializedFreeFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedFreeFunc"> -<ANCHOR id="DBusGTypeSpecializedMapAppendFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapAppendFunc"> -<ANCHOR id="DBusGTypeSpecializedMapIterator" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIterator"> -<ANCHOR id="DBusGTypeSpecializedMapIteratorFunc" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapIteratorFunc"> -<ANCHOR id="DBusGTypeSpecializedMapVtable" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedMapVtable"> -<ANCHOR id="DBusGTypeSpecializedStructGetMember" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructGetMember"> -<ANCHOR id="DBusGTypeSpecializedStructSetMember" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructSetMember"> -<ANCHOR id="DBusGTypeSpecializedStructVtable" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedStructVtable"> -<ANCHOR id="DBusGTypeSpecializedVtable" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#DBusGTypeSpecializedVtable"> -<ANCHOR id="dbus-g-type-collection-get-fixed" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-get-fixed"> -<ANCHOR id="dbus-g-type-collection-peek-vtable" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-peek-vtable"> -<ANCHOR id="dbus-g-type-collection-value-iterate" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-collection-value-iterate"> -<ANCHOR id="dbus-g-type-get-collection" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection"> -<ANCHOR id="dbus-g-type-get-collection-specialization" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-collection-specialization"> -<ANCHOR id="dbus-g-type-get-map" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map"> -<ANCHOR id="dbus-g-type-get-map-key-specialization" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map-key-specialization"> -<ANCHOR id="dbus-g-type-get-map-value-specialization" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-map-value-specialization"> -<ANCHOR id="dbus-g-type-get-struct" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct"> -<ANCHOR id="dbus-g-type-get-struct-member-type" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct-member-type"> -<ANCHOR id="dbus-g-type-get-struct-size" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-struct-size"> -<ANCHOR id="dbus-g-type-get-structv" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-get-structv"> -<ANCHOR id="dbus-g-type-is-collection" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-collection"> -<ANCHOR id="dbus-g-type-is-map" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-map"> -<ANCHOR id="dbus-g-type-is-struct" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-is-struct"> -<ANCHOR id="dbus-g-type-map-peek-vtable" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-peek-vtable"> -<ANCHOR id="dbus-g-type-map-value-iterate" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-map-value-iterate"> -<ANCHOR id="dbus-g-type-register-collection" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-collection"> -<ANCHOR id="dbus-g-type-register-map" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-map"> -<ANCHOR id="dbus-g-type-register-struct" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-register-struct"> -<ANCHOR id="dbus-g-type-specialized-collection-append" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-append"> -<ANCHOR id="dbus-g-type-specialized-collection-end-append" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-collection-end-append"> -<ANCHOR id="dbus-g-type-specialized-construct" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-construct"> -<ANCHOR id="dbus-g-type-specialized-init" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init"> -<ANCHOR id="dbus-g-type-specialized-init-append" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-init-append"> -<ANCHOR id="dbus-g-type-specialized-map-append" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-specialized-map-append"> -<ANCHOR id="dbus-g-type-struct-get" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-get"> -<ANCHOR id="dbus-g-type-struct-get-member" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-get-member"> -<ANCHOR id="dbus-g-type-struct-peek-vtable" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-peek-vtable"> -<ANCHOR id="dbus-g-type-struct-set" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-set"> -<ANCHOR id="dbus-g-type-struct-set-member" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-type-struct-set-member"> -<ANCHOR id="dbus-g-value-build-g-variant" href="dbus-glib/dbus-glib-dbus-gtype-specialized.html#dbus-g-value-build-g-variant"> -<ANCHOR id="dbus-glib-dbus-glib-lowlevel" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html"> -<ANCHOR id="dbus-glib-dbus-glib-lowlevel.stability-level" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-glib-dbus-glib-lowlevel.stability-level"> -<ANCHOR id="dbus-glib-dbus-glib-lowlevel.synopsis" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-glib-dbus-glib-lowlevel.synopsis"> -<ANCHOR id="dbus-glib-dbus-glib-lowlevel.description" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-glib-dbus-glib-lowlevel.description"> -<ANCHOR id="dbus-glib-dbus-glib-lowlevel.details" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-glib-dbus-glib-lowlevel.details"> -<ANCHOR id="DBUS-TYPE-CONNECTION:CAPS" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#DBUS-TYPE-CONNECTION:CAPS"> -<ANCHOR id="DBUS-TYPE-MESSAGE:CAPS" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#DBUS-TYPE-MESSAGE:CAPS"> -<ANCHOR id="dbus-connection-get-g-connection" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-connection-get-g-connection"> -<ANCHOR id="dbus-connection-get-g-type" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-connection-get-g-type"> -<ANCHOR id="dbus-connection-setup-with-g-main" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-connection-setup-with-g-main"> -<ANCHOR id="dbus-g-connection-get-connection" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-g-connection-get-connection"> -<ANCHOR id="dbus-g-message-get-message" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-g-message-get-message"> -<ANCHOR id="dbus-g-method-get-reply" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-get-reply"> -<ANCHOR id="dbus-g-method-get-sender" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-get-sender"> -<ANCHOR id="dbus-g-method-send-reply" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-g-method-send-reply"> -<ANCHOR id="dbus-g-proxy-send" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-g-proxy-send"> -<ANCHOR id="dbus-message-get-g-type" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-message-get-g-type"> -<ANCHOR id="dbus-server-setup-with-g-main" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-server-setup-with-g-main"> -<ANCHOR id="dbus-set-g-error" href="dbus-glib/dbus-glib-dbus-glib-lowlevel.html#dbus-set-g-error"> +<ANCHOR id="dbus-glib-DBusGConnection" href="dbus-glib/dbus-glib-DBusGConnection.html"> +<ANCHOR id="dbus-glib-DBusGConnection.stability-level" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-glib-DBusGConnection.stability-level"> +<ANCHOR id="dbus-glib-DBusGConnection.synopsis" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-glib-DBusGConnection.synopsis"> +<ANCHOR id="dbus-glib-DBusGConnection.description" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-glib-DBusGConnection.description"> +<ANCHOR id="dbus-glib-DBusGConnection.details" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-glib-DBusGConnection.details"> +<ANCHOR id="DBusGConnection" href="dbus-glib/dbus-glib-DBusGConnection.html#DBusGConnection"> +<ANCHOR id="DBUS-TYPE-G-CONNECTION:CAPS" href="dbus-glib/dbus-glib-DBusGConnection.html#DBUS-TYPE-G-CONNECTION:CAPS"> +<ANCHOR id="dbus-g-bus-get" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-bus-get"> +<ANCHOR id="dbus-g-bus-get-private" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-bus-get-private"> +<ANCHOR id="dbus-g-thread-init" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-thread-init"> +<ANCHOR id="dbus-g-connection-open" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-open"> +<ANCHOR id="dbus-g-connection-ref" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-ref"> +<ANCHOR id="dbus-g-connection-unref" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-unref"> +<ANCHOR id="dbus-g-connection-flush" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-flush"> +<ANCHOR id="dbus-g-connection-get-connection" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-get-connection"> +<ANCHOR id="dbus-g-connection-register-g-object" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-register-g-object"> +<ANCHOR id="dbus-g-connection-unregister-g-object" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-unregister-g-object"> +<ANCHOR id="dbus-g-connection-lookup-g-object" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-g-connection-lookup-g-object"> +<ANCHOR id="dbus-glib-DBusGConnection.see-also" href="dbus-glib/dbus-glib-DBusGConnection.html#dbus-glib-DBusGConnection.see-also"> +<ANCHOR id="dbus-glib-DBus-GObject-related-functions" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html"> +<ANCHOR id="dbus-glib-DBus-GObject-related-functions.stability-level" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-glib-DBus-GObject-related-functions.stability-level"> +<ANCHOR id="dbus-glib-DBus-GObject-related-functions.synopsis" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-glib-DBus-GObject-related-functions.synopsis"> +<ANCHOR id="dbus-glib-DBus-GObject-related-functions.description" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-glib-DBus-GObject-related-functions.description"> +<ANCHOR id="dbus-glib-DBus-GObject-related-functions.details" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-glib-DBus-GObject-related-functions.details"> +<ANCHOR id="DBusGObjectInfo" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo"> +<ANCHOR id="dbus-g-object-type-install-info" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-install-info"> +<ANCHOR id="dbus-g-object-type-register-shadow-property" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-register-shadow-property"> +<ANCHOR id="dbus-g-object-path-get-g-type" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-path-get-g-type"> +<ANCHOR id="dbus-g-object-register-marshaller" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller"> +<ANCHOR id="dbus-g-object-register-marshaller-array" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller-array"> +<ANCHOR id="dbus-glib-global-set-disable-legacy-property-access" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-glib-global-set-disable-legacy-property-access"> +<ANCHOR id="dbus-glib-DBus-GObject-related-functions.see-also" href="dbus-glib/dbus-glib-DBus-GObject-related-functions.html#dbus-glib-DBus-GObject-related-functions.see-also"> +<ANCHOR id="dbus-glib-DBusGMessage" href="dbus-glib/dbus-glib-DBusGMessage.html"> +<ANCHOR id="dbus-glib-DBusGMessage.stability-level" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-glib-DBusGMessage.stability-level"> +<ANCHOR id="dbus-glib-DBusGMessage.synopsis" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-glib-DBusGMessage.synopsis"> +<ANCHOR id="dbus-glib-DBusGMessage.description" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-glib-DBusGMessage.description"> +<ANCHOR id="dbus-glib-DBusGMessage.details" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-glib-DBusGMessage.details"> +<ANCHOR id="DBusGMessage" href="dbus-glib/dbus-glib-DBusGMessage.html#DBusGMessage"> +<ANCHOR id="DBUS-TYPE-G-MESSAGE:CAPS" href="dbus-glib/dbus-glib-DBusGMessage.html#DBUS-TYPE-G-MESSAGE:CAPS"> +<ANCHOR id="dbus-g-message-ref" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-g-message-ref"> +<ANCHOR id="dbus-g-message-unref" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-g-message-unref"> +<ANCHOR id="dbus-g-message-get-message" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-g-message-get-message"> +<ANCHOR id="dbus-glib-DBusGMessage.see-also" href="dbus-glib/dbus-glib-DBusGMessage.html#dbus-glib-DBusGMessage.see-also"> +<ANCHOR id="dbus-glib-DBusGMethod" href="dbus-glib/dbus-glib-DBusGMethod.html"> +<ANCHOR id="dbus-glib-DBusGMethod.stability-level" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-glib-DBusGMethod.stability-level"> +<ANCHOR id="dbus-glib-DBusGMethod.synopsis" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-glib-DBusGMethod.synopsis"> +<ANCHOR id="dbus-glib-DBusGMethod.description" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-glib-DBusGMethod.description"> +<ANCHOR id="dbus-glib-DBusGMethod.details" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-glib-DBusGMethod.details"> +<ANCHOR id="DBusGMethodInfo" href="dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInfo"> +<ANCHOR id="DBusGMethodInvocation" href="dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"> +<ANCHOR id="dbus-g-method-get-sender" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-get-sender"> +<ANCHOR id="dbus-g-method-get-reply" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-get-reply"> +<ANCHOR id="dbus-g-method-send-reply" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-send-reply"> +<ANCHOR id="dbus-g-method-return" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"> +<ANCHOR id="dbus-g-method-return-error" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return-error"> +<ANCHOR id="dbus-glib-DBusGMethod.see-also" href="dbus-glib/dbus-glib-DBusGMethod.html#dbus-glib-DBusGMethod.see-also"> +<ANCHOR id="dbus-glib-DBusGError" href="dbus-glib/dbus-glib-DBusGError.html"> +<ANCHOR id="dbus-glib-DBusGError.stability-level" href="dbus-glib/dbus-glib-DBusGError.html#dbus-glib-DBusGError.stability-level"> +<ANCHOR id="dbus-glib-DBusGError.synopsis" href="dbus-glib/dbus-glib-DBusGError.html#dbus-glib-DBusGError.synopsis"> +<ANCHOR id="dbus-glib-DBusGError.description" href="dbus-glib/dbus-glib-DBusGError.html#dbus-glib-DBusGError.description"> +<ANCHOR id="dbus-glib-DBusGError.details" href="dbus-glib/dbus-glib-DBusGError.html#dbus-glib-DBusGError.details"> +<ANCHOR id="DBusGError" href="dbus-glib/dbus-glib-DBusGError.html#DBusGError"> +<ANCHOR id="dbus-g-error-has-name" href="dbus-glib/dbus-glib-DBusGError.html#dbus-g-error-has-name"> +<ANCHOR id="dbus-g-error-get-name" href="dbus-glib/dbus-glib-DBusGError.html#dbus-g-error-get-name"> +<ANCHOR id="dbus-g-error-domain-register" href="dbus-glib/dbus-glib-DBusGError.html#dbus-g-error-domain-register"> +<ANCHOR id="DBUS-GERROR:CAPS" href="dbus-glib/dbus-glib-DBusGError.html#DBUS-GERROR:CAPS"> +<ANCHOR id="dbus-glib-DBusGError.see-also" href="dbus-glib/dbus-glib-DBusGError.html#dbus-glib-DBusGError.see-also"> +<ANCHOR id="dbus-glib-DBusGProxy" href="dbus-glib/dbus-glib-DBusGProxy.html"> +<ANCHOR id="dbus-glib-DBusGProxy.stability-level" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-glib-DBusGProxy.stability-level"> +<ANCHOR id="dbus-glib-DBusGProxy.synopsis" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-glib-DBusGProxy.synopsis"> +<ANCHOR id="dbus-glib-DBusGProxy.description" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-glib-DBusGProxy.description"> +<ANCHOR id="dbus-glib-DBusGProxy.details" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-glib-DBusGProxy.details"> +<ANCHOR id="DBusGProxy" href="dbus-glib/dbus-glib-DBusGProxy.html#DBusGProxy"> +<ANCHOR id="DBusGProxyCall" href="dbus-glib/dbus-glib-DBusGProxy.html#DBusGProxyCall"> +<ANCHOR id="DBusGProxyCallNotify" href="dbus-glib/dbus-glib-DBusGProxy.html#DBusGProxyCallNotify"> +<ANCHOR id="dbus-g-proxy-new-for-name" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name"> +<ANCHOR id="dbus-g-proxy-new-for-name-owner" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner"> +<ANCHOR id="dbus-g-proxy-new-from-proxy" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-new-from-proxy"> +<ANCHOR id="dbus-g-proxy-new-for-peer" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-peer"> +<ANCHOR id="dbus-g-proxy-set-interface" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-set-interface"> +<ANCHOR id="dbus-g-proxy-get-path" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-get-path"> +<ANCHOR id="dbus-g-proxy-get-bus-name" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-get-bus-name"> +<ANCHOR id="dbus-g-proxy-get-interface" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-get-interface"> +<ANCHOR id="dbus-g-proxy-add-signal" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-add-signal"> +<ANCHOR id="dbus-g-proxy-connect-signal" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-connect-signal"> +<ANCHOR id="dbus-g-proxy-disconnect-signal" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-disconnect-signal"> +<ANCHOR id="dbus-g-proxy-send" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-send"> +<ANCHOR id="dbus-g-proxy-call" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-call"> +<ANCHOR id="dbus-g-proxy-call-with-timeout" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-call-with-timeout"> +<ANCHOR id="dbus-g-proxy-call-no-reply" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-call-no-reply"> +<ANCHOR id="dbus-g-proxy-begin-call" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call"> +<ANCHOR id="dbus-g-proxy-begin-call-with-timeout" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call-with-timeout"> +<ANCHOR id="dbus-g-proxy-end-call" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call"> +<ANCHOR id="dbus-g-proxy-cancel-call" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-cancel-call"> +<ANCHOR id="dbus-g-proxy-set-default-timeout" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-g-proxy-set-default-timeout"> +<ANCHOR id="dbus-glib-DBusGProxy.see-also" href="dbus-glib/dbus-glib-DBusGProxy.html#dbus-glib-DBusGProxy.see-also"> +<ANCHOR id="dbus-glib-Specializable-GType-System" href="dbus-glib/dbus-glib-Specializable-GType-System.html"> +<ANCHOR id="dbus-glib-Specializable-GType-System.stability-level" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-glib-Specializable-GType-System.stability-level"> +<ANCHOR id="dbus-glib-Specializable-GType-System.synopsis" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-glib-Specializable-GType-System.synopsis"> +<ANCHOR id="dbus-glib-Specializable-GType-System.description" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-glib-Specializable-GType-System.description"> +<ANCHOR id="dbus-glib-Specializable-GType-System.details" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-glib-Specializable-GType-System.details"> +<ANCHOR id="DBusGTypeSpecializedCollectionIterator" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIterator"> +<ANCHOR id="DBusGTypeSpecializedMapIterator" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIterator"> +<ANCHOR id="DBusGTypeSpecializedAppendContext" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedAppendContext"> +<ANCHOR id="DBusGTypeSpecializedConstructor" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedConstructor"> +<ANCHOR id="DBusGTypeSpecializedFreeFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedFreeFunc"> +<ANCHOR id="DBusGTypeSpecializedCopyFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCopyFunc"> +<ANCHOR id="DBusGTypeSpecializedVtable" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedVtable"> +<ANCHOR id="DBusGTypeSpecializedCollectionFixedAccessorFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionFixedAccessorFunc"> +<ANCHOR id="DBusGTypeSpecializedCollectionIteratorFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionIteratorFunc"> +<ANCHOR id="DBusGTypeSpecializedCollectionAppendFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionAppendFunc"> +<ANCHOR id="DBusGTypeSpecializedCollectionEndAppendFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionEndAppendFunc"> +<ANCHOR id="DBusGTypeSpecializedCollectionVtable" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedCollectionVtable"> +<ANCHOR id="DBusGTypeSpecializedMapIteratorFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapIteratorFunc"> +<ANCHOR id="DBusGTypeSpecializedMapAppendFunc" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapAppendFunc"> +<ANCHOR id="DBusGTypeSpecializedMapVtable" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedMapVtable"> +<ANCHOR id="DBusGTypeSpecializedStructGetMember" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructGetMember"> +<ANCHOR id="DBusGTypeSpecializedStructSetMember" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructSetMember"> +<ANCHOR id="DBusGTypeSpecializedStructVtable" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGTypeSpecializedStructVtable"> +<ANCHOR id="dbus-g-type-get-collection" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection"> +<ANCHOR id="dbus-g-type-get-map" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map"> +<ANCHOR id="dbus-g-type-get-structv" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-structv"> +<ANCHOR id="dbus-g-type-get-struct" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct"> +<ANCHOR id="dbus-g-type-is-collection" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-is-collection"> +<ANCHOR id="dbus-g-type-is-map" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-is-map"> +<ANCHOR id="dbus-g-type-is-struct" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-is-struct"> +<ANCHOR id="dbus-g-type-get-collection-specialization" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-collection-specialization"> +<ANCHOR id="dbus-g-type-get-map-key-specialization" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map-key-specialization"> +<ANCHOR id="dbus-g-type-get-map-value-specialization" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-map-value-specialization"> +<ANCHOR id="dbus-g-type-get-struct-member-type" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct-member-type"> +<ANCHOR id="dbus-g-type-get-struct-size" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-get-struct-size"> +<ANCHOR id="dbus-g-type-specialized-construct" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-construct"> +<ANCHOR id="dbus-g-type-specialized-init-append" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init-append"> +<ANCHOR id="dbus-g-type-specialized-collection-append" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-append"> +<ANCHOR id="dbus-g-type-specialized-collection-end-append" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-collection-end-append"> +<ANCHOR id="dbus-g-type-specialized-map-append" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-map-append"> +<ANCHOR id="dbus-g-type-collection-get-fixed" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-get-fixed"> +<ANCHOR id="dbus-g-type-collection-value-iterate" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-value-iterate"> +<ANCHOR id="dbus-g-type-map-value-iterate" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-map-value-iterate"> +<ANCHOR id="dbus-g-type-struct-get-member" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-get-member"> +<ANCHOR id="dbus-g-type-struct-set-member" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-set-member"> +<ANCHOR id="dbus-g-type-struct-get" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-get"> +<ANCHOR id="dbus-g-type-struct-set" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-set"> +<ANCHOR id="dbus-g-type-specialized-init" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-specialized-init"> +<ANCHOR id="dbus-g-type-register-collection" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-register-collection"> +<ANCHOR id="dbus-g-type-register-map" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-register-map"> +<ANCHOR id="dbus-g-type-map-peek-vtable" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-map-peek-vtable"> +<ANCHOR id="dbus-g-type-collection-peek-vtable" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-collection-peek-vtable"> +<ANCHOR id="dbus-g-type-struct-peek-vtable" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-struct-peek-vtable"> +<ANCHOR id="dbus-g-type-register-struct" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-type-register-struct"> +<ANCHOR id="dbus-g-value-build-g-variant" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-value-build-g-variant"> +<ANCHOR id="dbus-g-value-parse-g-variant" href="dbus-glib/dbus-glib-Specializable-GType-System.html#dbus-g-value-parse-g-variant"> +<ANCHOR id="DBUS-TYPE-G-BOOLEAN-ARRAY:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-BOOLEAN-ARRAY:CAPS"> +<ANCHOR id="DBUS-TYPE-G-UCHAR-ARRAY:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UCHAR-ARRAY:CAPS"> +<ANCHOR id="DBUS-TYPE-G-UINT-ARRAY:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UINT-ARRAY:CAPS"> +<ANCHOR id="DBUS-TYPE-G-INT-ARRAY:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-INT-ARRAY:CAPS"> +<ANCHOR id="DBUS-TYPE-G-UINT64-ARRAY:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-UINT64-ARRAY:CAPS"> +<ANCHOR id="DBUS-TYPE-G-INT64-ARRAY:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-INT64-ARRAY:CAPS"> +<ANCHOR id="DBUS-TYPE-G-OBJECT-ARRAY:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-ARRAY:CAPS"> +<ANCHOR id="DBUS-TYPE-G-STRING-STRING-HASHTABLE:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-STRING-STRING-HASHTABLE:CAPS"> +<ANCHOR id="DBusGSignature" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGSignature"> +<ANCHOR id="DBUS-TYPE-G-SIGNATURE:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-SIGNATURE:CAPS"> +<ANCHOR id="DBusGObjectPath" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBusGObjectPath"> +<ANCHOR id="DBUS-TYPE-G-OBJECT-PATH:CAPS" href="dbus-glib/dbus-glib-Specializable-GType-System.html#DBUS-TYPE-G-OBJECT-PATH:CAPS"> +<ANCHOR id="dbus-glib-DBus-GLib-low-level" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html"> +<ANCHOR id="dbus-glib-DBus-GLib-low-level.stability-level" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-glib-DBus-GLib-low-level.stability-level"> +<ANCHOR id="dbus-glib-DBus-GLib-low-level.synopsis" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-glib-DBus-GLib-low-level.synopsis"> +<ANCHOR id="dbus-glib-DBus-GLib-low-level.description" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-glib-DBus-GLib-low-level.description"> +<ANCHOR id="dbus-glib-DBus-GLib-low-level.details" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-glib-DBus-GLib-low-level.details"> +<ANCHOR id="dbus-set-g-error" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-set-g-error"> +<ANCHOR id="dbus-connection-setup-with-g-main" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-connection-setup-with-g-main"> +<ANCHOR id="dbus-connection-get-g-connection" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-connection-get-g-connection"> +<ANCHOR id="dbus-server-setup-with-g-main" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#dbus-server-setup-with-g-main"> +<ANCHOR id="DBUS-TYPE-CONNECTION:CAPS" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#DBUS-TYPE-CONNECTION:CAPS"> +<ANCHOR id="DBUS-TYPE-MESSAGE:CAPS" href="dbus-glib/dbus-glib-DBus-GLib-low-level.html#DBUS-TYPE-MESSAGE:CAPS"> <ANCHOR id="dbus-binding-tool" href="dbus-glib/dbus-binding-tool.html"> diff --git a/doc/reference/tmpl/dbus-gconnection.sgml b/doc/reference/tmpl/dbus-gconnection.sgml index 196c59d..44541dc 100644 --- a/doc/reference/tmpl/dbus-gconnection.sgml +++ b/doc/reference/tmpl/dbus-gconnection.sgml @@ -9,11 +9,13 @@ DBusGConnection </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> diff --git a/doc/reference/tmpl/dbus-gerror.sgml b/doc/reference/tmpl/dbus-gerror.sgml index 5d32c08..4aee84e 100644 --- a/doc/reference/tmpl/dbus-gerror.sgml +++ b/doc/reference/tmpl/dbus-gerror.sgml @@ -9,11 +9,13 @@ DBusGError </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> diff --git a/doc/reference/tmpl/dbus-glib-lowlevel.sgml b/doc/reference/tmpl/dbus-glib-lowlevel.sgml index 2a56923..90ed0f0 100644 --- a/doc/reference/tmpl/dbus-glib-lowlevel.sgml +++ b/doc/reference/tmpl/dbus-glib-lowlevel.sgml @@ -9,47 +9,26 @@ DBus GLib low level </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> <!-- ##### SECTION Image ##### --> -<!-- ##### MACRO DBUS_TYPE_CONNECTION ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_MESSAGE ##### --> -<para> - -</para> - - - -<!-- ##### FUNCTION dbus_connection_get_g_connection ##### --> -<para> - -</para> - -@connection: -@Returns: - - -<!-- ##### FUNCTION dbus_connection_get_g_type ##### --> +<!-- ##### FUNCTION dbus_set_g_error ##### --> <para> </para> -@void: -@Returns: +@gerror: +@derror: <!-- ##### FUNCTION dbus_connection_setup_with_g_main ##### --> @@ -61,85 +40,35 @@ DBus GLib low level @context: -<!-- ##### FUNCTION dbus_g_connection_get_connection ##### --> -<para> - -</para> - -@gconnection: -@Returns: - - -<!-- ##### FUNCTION dbus_g_message_get_message ##### --> -<para> - -</para> - -@gmessage: -@Returns: - - -<!-- ##### FUNCTION dbus_g_method_get_reply ##### --> -<para> - -</para> - -@context: -@Returns: - - -<!-- ##### FUNCTION dbus_g_method_get_sender ##### --> +<!-- ##### FUNCTION dbus_connection_get_g_connection ##### --> <para> </para> -@context: +@connection: @Returns: -<!-- ##### FUNCTION dbus_g_method_send_reply ##### --> +<!-- ##### FUNCTION dbus_server_setup_with_g_main ##### --> <para> </para> +@server: @context: -@reply: - - -<!-- ##### FUNCTION dbus_g_proxy_send ##### --> -<para> - -</para> - -@proxy: -@message: -@client_serial: - -<!-- ##### FUNCTION dbus_message_get_g_type ##### --> -<para> - -</para> - -@void: -@Returns: - -<!-- ##### FUNCTION dbus_server_setup_with_g_main ##### --> +<!-- ##### MACRO DBUS_TYPE_CONNECTION ##### --> <para> </para> -@server: -@context: -<!-- ##### FUNCTION dbus_set_g_error ##### --> +<!-- ##### MACRO DBUS_TYPE_MESSAGE ##### --> <para> </para> -@gerror: -@derror: diff --git a/doc/reference/tmpl/dbus-glib-unused.sgml b/doc/reference/tmpl/dbus-glib-unused.sgml index b16a414..e69de29 100644 --- a/doc/reference/tmpl/dbus-glib-unused.sgml +++ b/doc/reference/tmpl/dbus-glib-unused.sgml @@ -1,545 +0,0 @@ -<!-- ##### SECTION ./tmpl/dbus-gconnection.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gconnection.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gconnection.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gconnection.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gconnection.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gconnection.sgml:Title ##### --> -DBusGConnection - - -<!-- ##### SECTION ./tmpl/dbus-gerror.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gerror.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gerror.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gerror.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gerror.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gerror.sgml:Title ##### --> -DBusGError - - -<!-- ##### SECTION ./tmpl/dbus-gmessage.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gmessage.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gmessage.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gmessage.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gmessage.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gmessage.sgml:Title ##### --> -DBusGMessage - - -<!-- ##### SECTION ./tmpl/dbus-gmethod.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gmethod.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gmethod.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gmethod.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gmethod.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gmethod.sgml:Title ##### --> -DBusGMethod - - -<!-- ##### SECTION ./tmpl/dbus-gproxy.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gproxy.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gproxy.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/dbus-gproxy.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gproxy.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/dbus-gproxy.sgml:Title ##### --> -DBusGProxy - - -<!-- ##### SECTION ./tmpl/example-service-glue.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/example-service-glue.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/example-service-glue.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/example-service-glue.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/example-service-glue.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/example-service-glue.sgml:Title ##### --> -example-service-glue - - -<!-- ##### SECTION ./tmpl/example-signal-emitter-glue.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/example-signal-emitter-glue.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/example-signal-emitter-glue.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/example-signal-emitter-glue.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/example-signal-emitter-glue.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/example-signal-emitter-glue.sgml:Title ##### --> -example-signal-emitter-glue - - -<!-- ##### SECTION ./tmpl/sm-marshal.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/sm-marshal.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/sm-marshal.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/sm-marshal.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/sm-marshal.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/sm-marshal.sgml:Title ##### --> -sm-marshal - - -<!-- ##### SECTION ./tmpl/statemachine-glue.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/statemachine-glue.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/statemachine-glue.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/statemachine-glue.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/statemachine-glue.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/statemachine-glue.sgml:Title ##### --> -statemachine-glue - - -<!-- ##### SECTION ./tmpl/statemachine-server-glue.sgml:Image ##### --> - - - -<!-- ##### SECTION ./tmpl/statemachine-server-glue.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/statemachine-server-glue.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/statemachine-server-glue.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/statemachine-server-glue.sgml:Stability_Level ##### --> - - - -<!-- ##### SECTION ./tmpl/statemachine-server-glue.sgml:Title ##### --> -statemachine-server-glue - - -<!-- ##### FUNCTION dbus_glib_marshal_sm_object_BOOLEAN__POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### FUNCTION dbus_glib_marshal_sm_object_BOOLEAN__POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### FUNCTION dbus_glib_marshal_sm_object_BOOLEAN__POINTER_POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### FUNCTION dbus_glib_marshal_sm_server_BOOLEAN__POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### FUNCTION dbus_glib_marshal_sm_server_BOOLEAN__STRING_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### FUNCTION dbus_glib_marshal_some_object_BOOLEAN__POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### FUNCTION dbus_glib_marshal_some_object_BOOLEAN__STRING_POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### FUNCTION dbus_glib_marshal_test_object_BOOLEAN__POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - -<!-- ##### VARIABLE dbus_glib_sm_object_object_info ##### --> -<para> - -</para> - - -<!-- ##### VARIABLE dbus_glib_sm_server_object_info ##### --> -<para> - -</para> - - -<!-- ##### VARIABLE dbus_glib_some_object_object_info ##### --> -<para> - -</para> - - -<!-- ##### VARIABLE dbus_glib_test_object_object_info ##### --> -<para> - -</para> - - -<!-- ##### MACRO g_marshal_value_peek_boolean ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_boxed ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_char ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_double ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_enum ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_flags ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_float ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_int ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_int64 ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_long ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_object ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_param ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_pointer ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_string ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_uchar ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_uint ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_uint64 ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_ulong ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO g_marshal_value_peek_variant ##### --> -<para> - -</para> - -@v: - -<!-- ##### FUNCTION sm_marshal_VOID__STRING_BOXED ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - diff --git a/doc/reference/tmpl/dbus-glib.sgml b/doc/reference/tmpl/dbus-glib.sgml deleted file mode 100644 index 19fb1a4..0000000 --- a/doc/reference/tmpl/dbus-glib.sgml +++ /dev/null @@ -1,749 +0,0 @@ -<!-- ##### SECTION Title ##### --> -DBusGProxy - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### MACRO DBUS_GERROR ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_INSIDE_DBUS_GLIB_H ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_BOOLEAN_ARRAY ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_CONNECTION ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_INT64_ARRAY ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_INT_ARRAY ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_MESSAGE ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_OBJECT_ARRAY ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_OBJECT_PATH ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_SIGNATURE ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_STRING_STRING_HASHTABLE ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_UCHAR_ARRAY ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_UINT64_ARRAY ##### --> -<para> - -</para> - - - -<!-- ##### MACRO DBUS_TYPE_G_UINT_ARRAY ##### --> -<para> - -</para> - - - -<!-- ##### STRUCT DBusGAsyncData ##### --> -<para> - -</para> - -@cb: -@userdata: - -<!-- ##### STRUCT DBusGConnection ##### --> -<para> - -</para> - - -<!-- ##### ENUM DBusGError ##### --> -<para> - -</para> - -@DBUS_GERROR_FAILED: -@DBUS_GERROR_NO_MEMORY: -@DBUS_GERROR_SERVICE_UNKNOWN: -@DBUS_GERROR_NAME_HAS_NO_OWNER: -@DBUS_GERROR_NO_REPLY: -@DBUS_GERROR_IO_ERROR: -@DBUS_GERROR_BAD_ADDRESS: -@DBUS_GERROR_NOT_SUPPORTED: -@DBUS_GERROR_LIMITS_EXCEEDED: -@DBUS_GERROR_ACCESS_DENIED: -@DBUS_GERROR_AUTH_FAILED: -@DBUS_GERROR_NO_SERVER: -@DBUS_GERROR_TIMEOUT: -@DBUS_GERROR_NO_NETWORK: -@DBUS_GERROR_ADDRESS_IN_USE: -@DBUS_GERROR_DISCONNECTED: -@DBUS_GERROR_INVALID_ARGS: -@DBUS_GERROR_FILE_NOT_FOUND: -@DBUS_GERROR_FILE_EXISTS: -@DBUS_GERROR_UNKNOWN_METHOD: -@DBUS_GERROR_TIMED_OUT: -@DBUS_GERROR_MATCH_RULE_NOT_FOUND: -@DBUS_GERROR_MATCH_RULE_INVALID: -@DBUS_GERROR_SPAWN_EXEC_FAILED: -@DBUS_GERROR_SPAWN_FORK_FAILED: -@DBUS_GERROR_SPAWN_CHILD_EXITED: -@DBUS_GERROR_SPAWN_CHILD_SIGNALED: -@DBUS_GERROR_SPAWN_FAILED: -@DBUS_GERROR_UNIX_PROCESS_ID_UNKNOWN: -@DBUS_GERROR_INVALID_SIGNATURE: -@DBUS_GERROR_INVALID_FILE_CONTENT: -@DBUS_GERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN: -@DBUS_GERROR_REMOTE_EXCEPTION: - -<!-- ##### STRUCT DBusGMessage ##### --> -<para> - -</para> - - -<!-- ##### STRUCT DBusGMethodInfo ##### --> -<para> - -</para> - -@function: -@marshaller: -@data_offset: - -<!-- ##### STRUCT DBusGMethodInvocation ##### --> -<para> - -</para> - - -<!-- ##### STRUCT DBusGObjectInfo ##### --> -<para> - -</para> - -@format_version: -@method_infos: -@n_method_infos: -@data: -@exported_signals: -@exported_properties: - -<!-- ##### TYPEDEF DBusGObjectPath ##### --> -<para> - -</para> - - -<!-- ##### STRUCT DBusGProxy ##### --> -<para> - -</para> - - -<!-- ##### SIGNAL DBusGProxy::destroy ##### --> -<para> - -</para> - -@dbusgproxy: the object which received the signal. - -<!-- ##### SIGNAL DBusGProxy::received ##### --> -<para> - -</para> - -@dbusgproxy: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### ARG DBusGProxy:connection ##### --> -<para> - -</para> - -<!-- ##### ARG DBusGProxy:interface ##### --> -<para> - -</para> - -<!-- ##### ARG DBusGProxy:name ##### --> -<para> - -</para> - -<!-- ##### ARG DBusGProxy:path ##### --> -<para> - -</para> - -<!-- ##### STRUCT DBusGProxyCall ##### --> -<para> - -</para> - - -<!-- ##### USER_FUNCTION DBusGProxyCallNotify ##### --> -<para> - -</para> - -@proxy: -@call_id: -@user_data: - - -<!-- ##### STRUCT DBusGProxyClass ##### --> -<para> - -</para> - - -<!-- ##### TYPEDEF DBusGSignature ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION dbus_g_bus_get ##### --> -<para> - -</para> - -@type: -@error: -@Returns: - - -<!-- ##### FUNCTION dbus_g_bus_get_private ##### --> -<para> - -</para> - -@type: -@context: -@error: -@Returns: - - -<!-- ##### FUNCTION dbus_g_connection_flush ##### --> -<para> - -</para> - -@connection: - - -<!-- ##### FUNCTION dbus_g_connection_get_g_type ##### --> -<para> - -</para> - -@void: -@Returns: - - -<!-- ##### FUNCTION dbus_g_connection_lookup_g_object ##### --> -<para> - -</para> - -@connection: -@at_path: -@Returns: - - -<!-- ##### FUNCTION dbus_g_connection_open ##### --> -<para> - -</para> - -@address: -@error: -@Returns: - - -<!-- ##### FUNCTION dbus_g_connection_ref ##### --> -<para> - -</para> - -@connection: -@Returns: - - -<!-- ##### FUNCTION dbus_g_connection_register_g_object ##### --> -<para> - -</para> - -@connection: -@at_path: -@object: - - -<!-- ##### FUNCTION dbus_g_connection_unref ##### --> -<para> - -</para> - -@connection: - - -<!-- ##### FUNCTION dbus_g_connection_unregister_g_object ##### --> -<para> - -</para> - -@connection: -@object: - - -<!-- ##### FUNCTION dbus_g_error_domain_register ##### --> -<para> - -</para> - -@domain: -@default_iface: -@code_enum: - - -<!-- ##### FUNCTION dbus_g_error_get_name ##### --> -<para> - -</para> - -@error: -@Returns: - - -<!-- ##### FUNCTION dbus_g_error_has_name ##### --> -<para> - -</para> - -@error: -@name: -@Returns: - - -<!-- ##### FUNCTION dbus_g_error_quark ##### --> -<para> - -</para> - -@void: -@Returns: - - -<!-- ##### FUNCTION dbus_g_message_get_g_type ##### --> -<para> - -</para> - -@void: -@Returns: - - -<!-- ##### FUNCTION dbus_g_message_ref ##### --> -<para> - -</para> - -@message: -@Returns: - - -<!-- ##### FUNCTION dbus_g_message_unref ##### --> -<para> - -</para> - -@message: - - -<!-- ##### FUNCTION dbus_g_method_return ##### --> -<para> - -</para> - -@context: -@...: - - -<!-- ##### FUNCTION dbus_g_method_return_error ##### --> -<para> - -</para> - -@context: -@error: - - -<!-- ##### FUNCTION dbus_g_object_path_get_g_type ##### --> -<para> - -</para> - -@void: -@Returns: - - -<!-- ##### FUNCTION dbus_g_object_register_marshaller ##### --> -<para> - -</para> - -@marshaller: -@rettype: -@...: - - -<!-- ##### FUNCTION dbus_g_object_register_marshaller_array ##### --> -<para> - -</para> - -@marshaller: -@rettype: -@n_types: -@types: - - -<!-- ##### FUNCTION dbus_g_object_type_install_info ##### --> -<para> - -</para> - -@object_type: -@info: - - -<!-- ##### FUNCTION dbus_g_object_type_register_shadow_property ##### --> -<para> - -</para> - -@iface_type: -@dbus_prop_name: -@shadow_prop_name: - - -<!-- ##### FUNCTION dbus_g_proxy_add_signal ##### --> -<para> - -</para> - -@proxy: -@signal_name: -@first_type: -@...: - - -<!-- ##### FUNCTION dbus_g_proxy_begin_call ##### --> -<para> - -</para> - -@proxy: -@method: -@notify: -@user_data: -@destroy: -@first_arg_type: -@...: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_begin_call_with_timeout ##### --> -<para> - -</para> - -@proxy: -@method: -@notify: -@user_data: -@destroy: -@timeout: -@first_arg_type: -@...: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_call ##### --> -<para> - -</para> - -@proxy: -@method: -@error: -@first_arg_type: -@...: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_call_no_reply ##### --> -<para> - -</para> - -@proxy: -@method: -@first_arg_type: -@...: - - -<!-- ##### FUNCTION dbus_g_proxy_call_with_timeout ##### --> -<para> - -</para> - -@proxy: -@method: -@timeout: -@error: -@first_arg_type: -@...: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_cancel_call ##### --> -<para> - -</para> - -@proxy: -@call: - - -<!-- ##### FUNCTION dbus_g_proxy_connect_signal ##### --> -<para> - -</para> - -@proxy: -@signal_name: -@handler: -@data: -@free_data_func: - - -<!-- ##### FUNCTION dbus_g_proxy_disconnect_signal ##### --> -<para> - -</para> - -@proxy: -@signal_name: -@handler: -@data: - - -<!-- ##### FUNCTION dbus_g_proxy_end_call ##### --> -<para> - -</para> - -@proxy: -@call: -@error: -@first_arg_type: -@...: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_get_bus_name ##### --> -<para> - -</para> - -@proxy: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_get_interface ##### --> -<para> - -</para> - -@proxy: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_get_path ##### --> -<para> - -</para> - -@proxy: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_new_for_name ##### --> -<para> - -</para> - -@connection: -@name: -@path: -@iface: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_new_for_name_owner ##### --> -<para> - -</para> - -@connection: -@name: -@path: -@iface: -@error: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_new_for_peer ##### --> -<para> - -</para> - -@connection: -@path: -@iface: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_new_from_proxy ##### --> -<para> - -</para> - -@proxy: -@iface: -@path: -@Returns: - - -<!-- ##### FUNCTION dbus_g_proxy_set_default_timeout ##### --> -<para> - -</para> - -@proxy: -@timeout: - - -<!-- ##### FUNCTION dbus_g_proxy_set_interface ##### --> -<para> - -</para> - -@proxy: -@interface_name: - - -<!-- ##### FUNCTION dbus_g_signature_get_g_type ##### --> -<para> - -</para> - -@void: -@Returns: - - -<!-- ##### FUNCTION dbus_g_thread_init ##### --> -<para> - -</para> - -@void: - - -<!-- ##### FUNCTION dbus_glib_global_set_disable_legacy_property_access ##### --> -<para> - -</para> - -@void: - - diff --git a/doc/reference/tmpl/dbus-gmessage.sgml b/doc/reference/tmpl/dbus-gmessage.sgml index 06437cd..d8a449f 100644 --- a/doc/reference/tmpl/dbus-gmessage.sgml +++ b/doc/reference/tmpl/dbus-gmessage.sgml @@ -9,11 +9,13 @@ DBusGMessage </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> diff --git a/doc/reference/tmpl/dbus-gmethod.sgml b/doc/reference/tmpl/dbus-gmethod.sgml index 9764bc2..878d866 100644 --- a/doc/reference/tmpl/dbus-gmethod.sgml +++ b/doc/reference/tmpl/dbus-gmethod.sgml @@ -9,11 +9,13 @@ DBusGMethod </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> diff --git a/doc/reference/tmpl/dbus-gobject.sgml b/doc/reference/tmpl/dbus-gobject.sgml index b8b84d0..425655a 100644 --- a/doc/reference/tmpl/dbus-gobject.sgml +++ b/doc/reference/tmpl/dbus-gobject.sgml @@ -9,14 +9,85 @@ DBus GObject related functions </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> <!-- ##### SECTION Image ##### --> +<!-- ##### STRUCT DBusGObjectInfo ##### --> +<para> + +</para> + +@format_version: +@method_infos: +@n_method_infos: +@data: +@exported_signals: +@exported_properties: + +<!-- ##### FUNCTION dbus_g_object_type_install_info ##### --> +<para> + +</para> + +@object_type: +@info: + + +<!-- ##### FUNCTION dbus_g_object_type_register_shadow_property ##### --> +<para> + +</para> + +@iface_type: +@dbus_prop_name: +@shadow_prop_name: + + +<!-- ##### FUNCTION dbus_g_object_path_get_g_type ##### --> +<para> + +</para> + +@void: +@Returns: + + +<!-- ##### FUNCTION dbus_g_object_register_marshaller ##### --> +<para> + +</para> + +@marshaller: +@rettype: +@...: + + +<!-- ##### FUNCTION dbus_g_object_register_marshaller_array ##### --> +<para> + +</para> + +@marshaller: +@rettype: +@n_types: +@types: + + +<!-- ##### FUNCTION dbus_glib_global_set_disable_legacy_property_access ##### --> +<para> + +</para> + +@void: + + diff --git a/doc/reference/tmpl/dbus-gproxy.sgml b/doc/reference/tmpl/dbus-gproxy.sgml index 58722c4..fb3b62e 100644 --- a/doc/reference/tmpl/dbus-gproxy.sgml +++ b/doc/reference/tmpl/dbus-gproxy.sgml @@ -9,11 +9,13 @@ DBusGProxy </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> diff --git a/doc/reference/tmpl/dbus-gtool-test.sgml b/doc/reference/tmpl/dbus-gtool-test.sgml deleted file mode 100644 index 7a4ba5f..0000000 --- a/doc/reference/tmpl/dbus-gtool-test.sgml +++ /dev/null @@ -1,22 +0,0 @@ -<!-- ##### SECTION Title ##### --> -dbus-gtool-test - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - diff --git a/doc/reference/tmpl/dbus-gtype-specialized-priv.sgml b/doc/reference/tmpl/dbus-gtype-specialized-priv.sgml deleted file mode 100644 index 84014d4..0000000 --- a/doc/reference/tmpl/dbus-gtype-specialized-priv.sgml +++ /dev/null @@ -1,22 +0,0 @@ -<!-- ##### SECTION Title ##### --> -dbus-gtype-specialized-priv - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - diff --git a/doc/reference/tmpl/dbus-gtype-specialized.sgml b/doc/reference/tmpl/dbus-gtype-specialized.sgml index 66193fd..d5998e3 100644 --- a/doc/reference/tmpl/dbus-gtype-specialized.sgml +++ b/doc/reference/tmpl/dbus-gtype-specialized.sgml @@ -9,132 +9,134 @@ Specializable GType System </para> + <!-- ##### SECTION See_Also ##### --> <para> </para> + <!-- ##### SECTION Stability_Level ##### --> <!-- ##### SECTION Image ##### --> -<!-- ##### STRUCT DBusGTypeSpecializedAppendContext ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionIterator ##### --> <para> </para> -@val: -@specialization_type: +@value: +@user_data: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionAppendFunc ##### --> + +<!-- ##### USER_FUNCTION DBusGTypeSpecializedMapIterator ##### --> <para> </para> -@ctx: -@val: +@key_val: +@value_val: +@user_data: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionEndAppendFunc ##### --> +<!-- ##### STRUCT DBusGTypeSpecializedAppendContext ##### --> <para> </para> -@ctx: - +@val: +@specialization_type: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionFixedAccessorFunc ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedConstructor ##### --> <para> </para> @type: -@instance: -@values: -@len: @Returns: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionIterator ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedFreeFunc ##### --> <para> </para> -@value: -@user_data: +@type: +@val: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionIteratorFunc ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedCopyFunc ##### --> <para> </para> @type: -@instance: -@iterator: -@user_data: +@src: +@Returns: -<!-- ##### STRUCT DBusGTypeSpecializedCollectionVtable ##### --> +<!-- ##### STRUCT DBusGTypeSpecializedVtable ##### --> <para> </para> -@base_vtable: -@fixed_accessor: -@iterator: -@append_func: -@end_append_func: +@constructor: +@free_func: +@copy_func: +@simple_free_func: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedConstructor ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionFixedAccessorFunc ##### --> <para> </para> @type: +@instance: +@values: +@len: @Returns: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedCopyFunc ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionIteratorFunc ##### --> <para> </para> @type: -@src: -@Returns: +@instance: +@iterator: +@user_data: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedFreeFunc ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionAppendFunc ##### --> <para> </para> -@type: +@ctx: @val: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedMapAppendFunc ##### --> +<!-- ##### USER_FUNCTION DBusGTypeSpecializedCollectionEndAppendFunc ##### --> <para> </para> @ctx: -@key: -@val: -<!-- ##### USER_FUNCTION DBusGTypeSpecializedMapIterator ##### --> +<!-- ##### STRUCT DBusGTypeSpecializedCollectionVtable ##### --> <para> </para> -@key_val: -@value_val: -@user_data: - +@base_vtable: +@fixed_accessor: +@iterator: +@append_func: +@end_append_func: <!-- ##### USER_FUNCTION DBusGTypeSpecializedMapIteratorFunc ##### --> <para> @@ -147,6 +149,16 @@ Specializable GType System @user_data: +<!-- ##### USER_FUNCTION DBusGTypeSpecializedMapAppendFunc ##### --> +<para> + +</para> + +@ctx: +@key: +@val: + + <!-- ##### STRUCT DBusGTypeSpecializedMapVtable ##### --> <para> @@ -189,57 +201,59 @@ Specializable GType System @get_member: @set_member: -<!-- ##### STRUCT DBusGTypeSpecializedVtable ##### --> +<!-- ##### FUNCTION dbus_g_type_get_collection ##### --> <para> </para> -@constructor: -@free_func: -@copy_func: -@simple_free_func: +@container: +@specialization: +@Returns: -<!-- ##### FUNCTION dbus_g_type_collection_get_fixed ##### --> + +<!-- ##### FUNCTION dbus_g_type_get_map ##### --> <para> </para> -@value: -@data_ret: -@len_ret: +@container: +@key_specialization: +@value_specialization: @Returns: -<!-- ##### FUNCTION dbus_g_type_collection_peek_vtable ##### --> +<!-- ##### FUNCTION dbus_g_type_get_structv ##### --> <para> </para> -@collection_type: +@container: +@num_members: +@types: @Returns: -<!-- ##### FUNCTION dbus_g_type_collection_value_iterate ##### --> +<!-- ##### FUNCTION dbus_g_type_get_struct ##### --> <para> </para> -@value: -@iterator: -@user_data: +@container: +@first_type: +@...: +@Returns: -<!-- ##### FUNCTION dbus_g_type_get_collection ##### --> +<!-- ##### FUNCTION dbus_g_type_is_collection ##### --> <para> </para> -@container: -@specialization: +@gtype: @Returns: -<!-- ##### FUNCTION dbus_g_type_get_collection_specialization ##### --> +<!-- ##### FUNCTION dbus_g_type_is_map ##### --> <para> </para> @@ -248,18 +262,16 @@ Specializable GType System @Returns: -<!-- ##### FUNCTION dbus_g_type_get_map ##### --> +<!-- ##### FUNCTION dbus_g_type_is_struct ##### --> <para> </para> -@container: -@key_specialization: -@value_specialization: +@gtype: @Returns: -<!-- ##### FUNCTION dbus_g_type_get_map_key_specialization ##### --> +<!-- ##### FUNCTION dbus_g_type_get_collection_specialization ##### --> <para> </para> @@ -268,7 +280,7 @@ Specializable GType System @Returns: -<!-- ##### FUNCTION dbus_g_type_get_map_value_specialization ##### --> +<!-- ##### FUNCTION dbus_g_type_get_map_key_specialization ##### --> <para> </para> @@ -277,14 +289,12 @@ Specializable GType System @Returns: -<!-- ##### FUNCTION dbus_g_type_get_struct ##### --> +<!-- ##### FUNCTION dbus_g_type_get_map_value_specialization ##### --> <para> </para> -@container: -@first_type: -@...: +@gtype: @Returns: @@ -307,53 +317,72 @@ Specializable GType System @Returns: -<!-- ##### FUNCTION dbus_g_type_get_structv ##### --> +<!-- ##### FUNCTION dbus_g_type_specialized_construct ##### --> <para> </para> -@container: -@num_members: -@types: +@gtype: @Returns: -<!-- ##### FUNCTION dbus_g_type_is_collection ##### --> +<!-- ##### FUNCTION dbus_g_type_specialized_init_append ##### --> <para> </para> -@gtype: -@Returns: +@value: +@ctx: -<!-- ##### FUNCTION dbus_g_type_is_map ##### --> +<!-- ##### FUNCTION dbus_g_type_specialized_collection_append ##### --> <para> </para> -@gtype: -@Returns: +@ctx: +@elt: -<!-- ##### FUNCTION dbus_g_type_is_struct ##### --> +<!-- ##### FUNCTION dbus_g_type_specialized_collection_end_append ##### --> <para> </para> -@gtype: -@Returns: +@ctx: -<!-- ##### FUNCTION dbus_g_type_map_peek_vtable ##### --> +<!-- ##### FUNCTION dbus_g_type_specialized_map_append ##### --> <para> </para> -@map_type: +@ctx: +@key: +@val: + + +<!-- ##### FUNCTION dbus_g_type_collection_get_fixed ##### --> +<para> + +</para> + +@value: +@data_ret: +@len_ret: @Returns: +<!-- ##### FUNCTION dbus_g_type_collection_value_iterate ##### --> +<para> + +</para> + +@value: +@iterator: +@user_data: + + <!-- ##### FUNCTION dbus_g_type_map_value_iterate ##### --> <para> @@ -364,6 +393,58 @@ Specializable GType System @user_data: +<!-- ##### FUNCTION dbus_g_type_struct_get_member ##### --> +<para> + +</para> + +@value: +@member: +@dest: +@Returns: + + +<!-- ##### FUNCTION dbus_g_type_struct_set_member ##### --> +<para> + +</para> + +@value: +@member: +@src: +@Returns: + + +<!-- ##### FUNCTION dbus_g_type_struct_get ##### --> +<para> + +</para> + +@value: +@member: +@...: +@Returns: + + +<!-- ##### FUNCTION dbus_g_type_struct_set ##### --> +<para> + +</para> + +@value: +@member: +@...: +@Returns: + + +<!-- ##### FUNCTION dbus_g_type_specialized_init ##### --> +<para> + +</para> + +@void: + + <!-- ##### FUNCTION dbus_g_type_register_collection ##### --> <para> @@ -384,6 +465,33 @@ Specializable GType System @flags: +<!-- ##### FUNCTION dbus_g_type_map_peek_vtable ##### --> +<para> + +</para> + +@map_type: +@Returns: + + +<!-- ##### FUNCTION dbus_g_type_collection_peek_vtable ##### --> +<para> + +</para> + +@collection_type: +@Returns: + + +<!-- ##### FUNCTION dbus_g_type_struct_peek_vtable ##### --> +<para> + +</para> + +@struct_type: +@Returns: + + <!-- ##### FUNCTION dbus_g_type_register_struct ##### --> <para> @@ -394,118 +502,103 @@ Specializable GType System @flags: -<!-- ##### FUNCTION dbus_g_type_specialized_collection_append ##### --> +<!-- ##### FUNCTION dbus_g_value_build_g_variant ##### --> <para> </para> -@ctx: -@elt: +@value: +@Returns: -<!-- ##### FUNCTION dbus_g_type_specialized_collection_end_append ##### --> +<!-- ##### FUNCTION dbus_g_value_parse_g_variant ##### --> <para> </para> -@ctx: +@variant: +@value: -<!-- ##### FUNCTION dbus_g_type_specialized_construct ##### --> +<!-- ##### MACRO DBUS_TYPE_G_BOOLEAN_ARRAY ##### --> <para> </para> -@gtype: -@Returns: -<!-- ##### FUNCTION dbus_g_type_specialized_init ##### --> +<!-- ##### MACRO DBUS_TYPE_G_UCHAR_ARRAY ##### --> <para> </para> -@void: -<!-- ##### FUNCTION dbus_g_type_specialized_init_append ##### --> +<!-- ##### MACRO DBUS_TYPE_G_UINT_ARRAY ##### --> <para> </para> -@value: -@ctx: -<!-- ##### FUNCTION dbus_g_type_specialized_map_append ##### --> +<!-- ##### MACRO DBUS_TYPE_G_INT_ARRAY ##### --> <para> </para> -@ctx: -@key: -@val: -<!-- ##### FUNCTION dbus_g_type_struct_get ##### --> +<!-- ##### MACRO DBUS_TYPE_G_UINT64_ARRAY ##### --> <para> </para> -@value: -@member: -@...: -@Returns: -<!-- ##### FUNCTION dbus_g_type_struct_get_member ##### --> +<!-- ##### MACRO DBUS_TYPE_G_INT64_ARRAY ##### --> <para> </para> -@value: -@member: -@dest: -@Returns: -<!-- ##### FUNCTION dbus_g_type_struct_peek_vtable ##### --> +<!-- ##### MACRO DBUS_TYPE_G_OBJECT_ARRAY ##### --> <para> </para> -@struct_type: -@Returns: -<!-- ##### FUNCTION dbus_g_type_struct_set ##### --> +<!-- ##### MACRO DBUS_TYPE_G_STRING_STRING_HASHTABLE ##### --> <para> </para> -@value: -@member: -@...: -@Returns: -<!-- ##### FUNCTION dbus_g_type_struct_set_member ##### --> +<!-- ##### TYPEDEF DBusGSignature ##### --> <para> </para> -@value: -@member: -@src: -@Returns: +<!-- ##### MACRO DBUS_TYPE_G_SIGNATURE ##### --> +<para> -<!-- ##### FUNCTION dbus_g_value_build_g_variant ##### --> +</para> + + + +<!-- ##### TYPEDEF DBusGObjectPath ##### --> +<para> + +</para> + + +<!-- ##### MACRO DBUS_TYPE_G_OBJECT_PATH ##### --> <para> </para> -@value: -@Returns: diff --git a/doc/reference/tmpl/dbus-gvalue-parse-variant.sgml b/doc/reference/tmpl/dbus-gvalue-parse-variant.sgml deleted file mode 100644 index c40fe97..0000000 --- a/doc/reference/tmpl/dbus-gvalue-parse-variant.sgml +++ /dev/null @@ -1,31 +0,0 @@ -<!-- ##### SECTION Title ##### --> -dbus-gvalue-parse-variant - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### FUNCTION dbus_g_value_parse_g_variant ##### --> -<para> - -</para> - -@variant: -@value: - - diff --git a/doc/reference/tmpl/example-service-glue.sgml b/doc/reference/tmpl/example-service-glue.sgml deleted file mode 100644 index cb206cb..0000000 --- a/doc/reference/tmpl/example-service-glue.sgml +++ /dev/null @@ -1,208 +0,0 @@ -<!-- ##### SECTION Title ##### --> -example-service-glue - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### FUNCTION dbus_glib_marshal_some_object_BOOLEAN__POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### FUNCTION dbus_glib_marshal_some_object_BOOLEAN__STRING_POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### VARIABLE dbus_glib_some_object_object_info ##### --> -<para> - -</para> - - -<!-- ##### MACRO g_marshal_value_peek_boolean ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_boxed ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_char ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_double ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_enum ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_flags ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_float ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_long ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_object ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_param ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_pointer ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_string ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uchar ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_ulong ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_variant ##### --> -<para> - -</para> - -@v: - - diff --git a/doc/reference/tmpl/example-signal-emitter-glue.sgml b/doc/reference/tmpl/example-signal-emitter-glue.sgml deleted file mode 100644 index ed7e6ba..0000000 --- a/doc/reference/tmpl/example-signal-emitter-glue.sgml +++ /dev/null @@ -1,195 +0,0 @@ -<!-- ##### SECTION Title ##### --> -example-signal-emitter-glue - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### FUNCTION dbus_glib_marshal_test_object_BOOLEAN__POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### VARIABLE dbus_glib_test_object_object_info ##### --> -<para> - -</para> - - -<!-- ##### MACRO g_marshal_value_peek_boolean ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_boxed ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_char ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_double ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_enum ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_flags ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_float ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_long ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_object ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_param ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_pointer ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_string ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uchar ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_ulong ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_variant ##### --> -<para> - -</para> - -@v: - - diff --git a/doc/reference/tmpl/sm-marshal.sgml b/doc/reference/tmpl/sm-marshal.sgml deleted file mode 100644 index fdd7586..0000000 --- a/doc/reference/tmpl/sm-marshal.sgml +++ /dev/null @@ -1,37 +0,0 @@ -<!-- ##### SECTION Title ##### --> -sm-marshal - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### FUNCTION sm_marshal_VOID__STRING_BOXED ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - diff --git a/doc/reference/tmpl/statemachine-glue.sgml b/doc/reference/tmpl/statemachine-glue.sgml deleted file mode 100644 index 23d70b6..0000000 --- a/doc/reference/tmpl/statemachine-glue.sgml +++ /dev/null @@ -1,221 +0,0 @@ -<!-- ##### SECTION Title ##### --> -statemachine-glue - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### FUNCTION dbus_glib_marshal_sm_object_BOOLEAN__POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### FUNCTION dbus_glib_marshal_sm_object_BOOLEAN__POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### FUNCTION dbus_glib_marshal_sm_object_BOOLEAN__POINTER_POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### VARIABLE dbus_glib_sm_object_object_info ##### --> -<para> - -</para> - - -<!-- ##### MACRO g_marshal_value_peek_boolean ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_boxed ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_char ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_double ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_enum ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_flags ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_float ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_long ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_object ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_param ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_pointer ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_string ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uchar ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_ulong ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_variant ##### --> -<para> - -</para> - -@v: - - diff --git a/doc/reference/tmpl/statemachine-server-glue.sgml b/doc/reference/tmpl/statemachine-server-glue.sgml deleted file mode 100644 index cddf9ab..0000000 --- a/doc/reference/tmpl/statemachine-server-glue.sgml +++ /dev/null @@ -1,208 +0,0 @@ -<!-- ##### SECTION Title ##### --> -statemachine-server-glue - -<!-- ##### SECTION Short_Description ##### --> - - -<!-- ##### SECTION Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### FUNCTION dbus_glib_marshal_sm_server_BOOLEAN__POINTER_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### FUNCTION dbus_glib_marshal_sm_server_BOOLEAN__STRING_POINTER ##### --> -<para> - -</para> - -@closure: -@return_value: -@n_param_values: -@param_values: -@invocation_hint: -@marshal_data: - - -<!-- ##### VARIABLE dbus_glib_sm_server_object_info ##### --> -<para> - -</para> - - -<!-- ##### MACRO g_marshal_value_peek_boolean ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_boxed ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_char ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_double ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_enum ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_flags ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_float ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_int64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_long ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_object ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_param ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_pointer ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_string ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uchar ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_uint64 ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_ulong ##### --> -<para> - -</para> - -@v: - - -<!-- ##### MACRO g_marshal_value_peek_variant ##### --> -<para> - -</para> - -@v: - - diff --git a/doc/reference/version.xml b/doc/reference/version.xml index 6191422..cd7b0cc 100644 --- a/doc/reference/version.xml +++ b/doc/reference/version.xml @@ -1 +1 @@ -0.100 +0.100.2 @@ -1,7 +1,7 @@ #!/bin/sh # install - install a program, script, or datafile -scriptversion=2009-04-28.21; # UTC +scriptversion=2011-01-19.21; # UTC # This originates from X11R5 (mit/util/scripts/install.sh), which was # later released in X11R6 (xc/config/util/install.sh) with the @@ -156,6 +156,10 @@ while test $# -ne 0; do -s) stripcmd=$stripprog;; -t) dst_arg=$2 + # Protect names problematic for `test' and other utilities. + case $dst_arg in + -* | [=\(\)!]) dst_arg=./$dst_arg;; + esac shift;; -T) no_target_directory=true;; @@ -186,6 +190,10 @@ if test $# -ne 0 && test -z "$dir_arg$dst_arg"; then fi shift # arg dst_arg=$arg + # Protect names problematic for `test' and other utilities. + case $dst_arg in + -* | [=\(\)!]) dst_arg=./$dst_arg;; + esac done fi @@ -200,7 +208,11 @@ if test $# -eq 0; then fi if test -z "$dir_arg"; then - trap '(exit $?); exit' 1 2 13 15 + do_exit='(exit $ret); exit $ret' + trap "ret=129; $do_exit" 1 + trap "ret=130; $do_exit" 2 + trap "ret=141; $do_exit" 13 + trap "ret=143; $do_exit" 15 # Set umask so as not to create temps with too-generous modes. # However, 'strip' requires both read and write access to temps. @@ -228,9 +240,9 @@ fi for src do - # Protect names starting with `-'. + # Protect names problematic for `test' and other utilities. case $src in - -*) src=./$src;; + -* | [=\(\)!]) src=./$src;; esac if test -n "$dir_arg"; then @@ -252,12 +264,7 @@ do echo "$0: no destination specified." >&2 exit 1 fi - dst=$dst_arg - # Protect names starting with `-'. - case $dst in - -*) dst=./$dst;; - esac # If destination is a directory, append the input filename; won't work # if double slashes aren't ignored. @@ -385,7 +392,7 @@ do case $dstdir in /*) prefix='/';; - -*) prefix='./';; + [-=\(\)!]*) prefix='./';; *) prefix='';; esac @@ -403,7 +410,7 @@ do for d do - test -z "$d" && continue + test X"$d" = X && continue prefix=$prefix$d if test -d "$prefix"; then @@ -70,7 +70,7 @@ # compiler: $LTCC # compiler flags: $LTCFLAGS # linker: $LD (gnu? $with_gnu_ld) -# $progname: (GNU libtool) 2.4.2 Debian-2.4.2-1.1 +# $progname: (GNU libtool) 2.4.2 Debian-2.4.2-1.2 # automake: $automake_version # autoconf: $autoconf_version # @@ -80,7 +80,7 @@ PROGRAM=libtool PACKAGE=libtool -VERSION="2.4.2 Debian-2.4.2-1.1" +VERSION="2.4.2 Debian-2.4.2-1.2" TIMESTAMP="" package_revision=1.3337 diff --git a/m4/Makefile.in b/m4/Makefile.in index 4356b38..089cc53 100644 --- a/m4/Makefile.in +++ b/m4/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/m4/libtool.m4 b/m4/libtool.m4 index 534d1cc..02b4bbe 100644 --- a/m4/libtool.m4 +++ b/m4/libtool.m4 @@ -1324,7 +1324,14 @@ s390*-*linux*|s390*-*tpf*|sparc*-*linux*) LD="${LD-ld} -m elf_i386_fbsd" ;; x86_64-*linux*) - LD="${LD-ld} -m elf_i386" + case `/usr/bin/file conftest.o` in + *x86-64*) + LD="${LD-ld} -m elf32_x86_64" + ;; + *) + LD="${LD-ld} -m elf_i386" + ;; + esac ;; ppc64-*linux*|powerpc64-*linux*) LD="${LD-ld} -m elf32ppclinux" @@ -1688,7 +1695,8 @@ AC_CACHE_VAL([lt_cv_sys_max_cmd_len], [dnl ;; *) lt_cv_sys_max_cmd_len=`(getconf ARG_MAX) 2> /dev/null` - if test -n "$lt_cv_sys_max_cmd_len"; then + if test -n "$lt_cv_sys_max_cmd_len" && \ + test undefined != "$lt_cv_sys_max_cmd_len"; then lt_cv_sys_max_cmd_len=`expr $lt_cv_sys_max_cmd_len \/ 4` lt_cv_sys_max_cmd_len=`expr $lt_cv_sys_max_cmd_len \* 3` else @@ -1,10 +1,10 @@ #! /bin/sh # Common stub for a few missing GNU programs while installing. -scriptversion=2009-04-28.21; # UTC +scriptversion=2012-01-06.13; # UTC # Copyright (C) 1996, 1997, 1999, 2000, 2002, 2003, 2004, 2005, 2006, -# 2008, 2009 Free Software Foundation, Inc. +# 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. # Originally by Fran,cois Pinard <pinard@iro.umontreal.ca>, 1996. # This program is free software; you can redistribute it and/or modify @@ -84,7 +84,6 @@ Supported PROGRAM values: help2man touch the output file lex create \`lex.yy.c', if possible, from existing .c makeinfo touch the output file - tar try tar, gnutar, gtar, then tar without non-portable flags yacc create \`y.tab.[ch]', if possible, from existing .[ch] Version suffixes to PROGRAM as well as the prefixes \`gnu-', \`gnu', and @@ -122,15 +121,6 @@ case $1 in # Not GNU programs, they don't have --version. ;; - tar*) - if test -n "$run"; then - echo 1>&2 "ERROR: \`tar' requires --run" - exit 1 - elif test "x$2" = "x--version" || test "x$2" = "x--help"; then - exit 1 - fi - ;; - *) if test -z "$run" && ($1 --version) > /dev/null 2>&1; then # We have it, but it failed. @@ -226,7 +216,7 @@ WARNING: \`$1' $msg. You should only need it if \`Bison' from any GNU archive site." rm -f y.tab.c y.tab.h if test $# -ne 1; then - eval LASTARG="\${$#}" + eval LASTARG=\${$#} case $LASTARG in *.y) SRCFILE=`echo "$LASTARG" | sed 's/y$/c/'` @@ -256,7 +246,7 @@ WARNING: \`$1' is $msg. You should only need it if \`Flex' from any GNU archive site." rm -f lex.yy.c if test $# -ne 1; then - eval LASTARG="\${$#}" + eval LASTARG=\${$#} case $LASTARG in *.l) SRCFILE=`echo "$LASTARG" | sed 's/l$/c/'` @@ -318,41 +308,6 @@ WARNING: \`$1' is $msg. You should only need it if touch $file ;; - tar*) - shift - - # We have already tried tar in the generic part. - # Look for gnutar/gtar before invocation to avoid ugly error - # messages. - if (gnutar --version > /dev/null 2>&1); then - gnutar "$@" && exit 0 - fi - if (gtar --version > /dev/null 2>&1); then - gtar "$@" && exit 0 - fi - firstarg="$1" - if shift; then - case $firstarg in - *o*) - firstarg=`echo "$firstarg" | sed s/o//` - tar "$firstarg" "$@" && exit 0 - ;; - esac - case $firstarg in - *h*) - firstarg=`echo "$firstarg" | sed s/h//` - tar "$firstarg" "$@" && exit 0 - ;; - esac - fi - - echo 1>&2 "\ -WARNING: I can't seem to be able to run \`tar' with the given arguments. - You may want to install GNU tar or Free paxutils, or check the - command line arguments." - exit 1 - ;; - *) echo 1>&2 "\ WARNING: \`$1' is needed, and is $msg. diff --git a/test/Makefile.in b/test/Makefile.in index 7c1d21d..6b9a957 100644 --- a/test/Makefile.in +++ b/test/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/test/core/Makefile.in b/test/core/Makefile.in index 45e3728..30bf3cd 100644 --- a/test/core/Makefile.in +++ b/test/core/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/test/interfaces/Makefile.in b/test/interfaces/Makefile.in index ec1f870..d40d750 100644 --- a/test/interfaces/Makefile.in +++ b/test/interfaces/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/test/lib/Makefile.in b/test/lib/Makefile.in index cc8e99d..e72fc37 100644 --- a/test/lib/Makefile.in +++ b/test/lib/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/test/manual/Makefile.in b/test/manual/Makefile.in index 04dbf4d..4e6cf56 100644 --- a/test/manual/Makefile.in +++ b/test/manual/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, diff --git a/tools/Makefile.in b/tools/Makefile.in index 7a43989..6d0f1fd 100644 --- a/tools/Makefile.in +++ b/tools/Makefile.in @@ -1,4 +1,4 @@ -# Makefile.in generated by automake 1.11.5 from Makefile.am. +# Makefile.in generated by automake 1.11.6 from Makefile.am. # @configure_input@ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, |