Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SYNCE_INFO_NEW(3)	     http://www.synce.org/	     SYNCE_INFO_NEW(3)

NAME
       synce_info_new -	allocate a new SynceInfo struct

SYNOPSIS
       #include	<synce.h>

       SynceInfo *synce_info_new(const char *device_name);

       void synce_info_destroy(SynceInfo *info);

       const char *synce_info_get_name(SynceInfo *info);
       bool synce_info_get_os_version(SynceInfo	*info, int os_major, int os_minor);
       int synce_info_get_build_number(SynceInfo *info);
       int synce_info_get_processor_type(SynceInfo *info);
       const char *synce_info_get_os_name(SynceInfo *info);
       const char *synce_info_get_model(SynceInfo *info);
       const char *synce_info_get_device_ip(SynceInfo *info);
       const char *synce_info_get_local_ip(SynceInfo *info);
       int synce_info_get_partner_id_1(SynceInfo *info);
       int synce_info_get_partner_id_2(SynceInfo *info);
       const char *synce_info_get_object_path(SynceInfo	*info);
       pid_t synce_info_get_dccm_pid(SynceInfo *info);
       const char *synce_info_get_transport(SynceInfo *info);
       const char *synce_info_get_password(SynceInfo *info);
       int synce_info_get_key(SynceInfo	*info);

DESCRIPTION
       The  synce_info_new()  function	returns	a pointer to a newly allocated
       and populated SynceInfo struct for a mobile device.

       If device_name is non-NULL, the returned	struct relates to a mobile de-
       vice with that name, or NULL if no device of that name is connected.

       If  device_name	is NULL, the exact behaviour depends on	the flavour of
       dccm daemon in use.  When using vdccm(1)	or the deprecated dccm(1), the
       current active device is	selected. This is usually the last device con-
       nected, specifically that described in the active_connection file which
       is  by  default in the ~/.synce/	directory. With	odccm(1) the first de-
       vice connected will be returned.	With synce-hal this depends on the de-
       vice(s) in question, and	should be considered undefined.

       This struct should be freed with	synce_info_destroy(3).

	      typedef struct _SynceInfo	{
		  pid_t	dccm_pid;	/* process id of dccm daemon */
		  char*	device_ip;	/* device ip address */
		  char*	local_iface_ip;	/* local interface ip address */
		  char*	password;	/* device password */
		  int key;		/* device pass key */
		  int os_major;		/* device OS major version */
		  int os_minor;		/* device OS minor version */
		  int build_number;	/* OS build number */
		  int processor_type;	/* device processor */
		  int partner_id_1;	/* first sync partner id number	*/
		  int partner_id_2;	/* second sync partner id number */
		  char*	name;		/* device name */
		  char*	os_name;	/* device OS name eg. PocketPC */
		  char*	model;		/* device hardware name	*/
		  char*	transport;	/* interface type */
		  char*	object_path;	/* path	to device's information	*/
	      }	SynceInfo;

       These  fields  must be accessed with the	synce_info_get_	functions. The
       particular fields populated depend on the flavour  of  dccm  daemon  in
       use.

       The  use	 of  dccm(1) is	deprecated. When using vdccm(1)	all fields are
       populated except	for local_iface_ip and os_minor.   With	 odccm(1)  and
       synce-hal,  dccm_pid,  password,	 key,  build_number,  partner_id_1 and
       partner_id_2 are	 not  used.   odccm(1)	also  does  not	 populate  lo-
       cal_iface_ip.

RETURN VALUE
       The synce_info_new() function returns a pointer to the allocated	Synce-
       Info struct, or NULL if an error	occured.

SEE ALSO
       synce(7), odccm(1), vdccm(1)

The SynCE Project		  2007-08-26		     SYNCE_INFO_NEW(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=synce_info_new&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help