DlpReadNetSyncInfo(3)

NAME
DlpReadNetSyncInfo, DlpWriteNetSyncInfo - read/write network HotSync information to a PalmOS device

LIBRARY
libpconn

SYNOPSIS
#include <palm.h>
#include <pconn/pconn.h>
int
DlpReadNetSyncInfo(PConnection *pconn, struct dlp_netsyncinfo *netsyncinfo);
int
DlpWriteNetSyncInfo(PConnection *pconn, const ubyte modflags, const struct dlp_netsyncinfo *newinfo);

DESCRIPTION
DlpReadNetSyncInfo reads network HotSync settings from a Palm.

netsyncinfo is filled in with this information. The dlp_netsyncinfo structure is defined as

    struct dlp_netsyncinfo
    {
            ubyte lansync_on;
            uword hostnamesize;
            uword hostaddrsize;
            uword hostnetmasksize;
            char hostname[DLPCMD_MAXHOSTNAMELEN];
            char hostaddr[DLPCMD_MAXADDRLEN];
            char hostnetmask[DLPCMD_MAXNETMASKLEN];
    };

where lansync_on is non-zero if LAN sync is enabled; hostnamesize, hostaddrsize, and hostnetmasksize give the length of the strings in hostname, hostaddr, and hostnetmask, respectively (these lengths include the terminating NUL); hostname is filled in with the name of the sync host, as an ASCII string; hostaddr is filled in with the IP address of the sync host, as an ASCII string, e.g, “192.168.123.5”; hostnetmask is filled in with the sync host's netmask, as an ASCII string, e.g., “255.255.0.0”.

It is not clear what the relationship between the host name, address, and netmask is. Perhaps it is possible for the Palm to send a broadcast request to a subnet to request a host with which to sync.

DlpWriteNetSyncInfo writes new network HotSync information to the Palm.

newinfo contains the data to upload. It is not necessary to fill in all of the fields, only those which one wishes to modify.

modflags specifies which fields to update:
DLPCMD_MODNSFLAG_LANSYNC
    newinfo.lansync_on
DLPCMD_MODNSFLAG_HOSTNAME
    newinfo.hostnamesize and newinfo.hostname
DLPCMD_MODNSFLAG_HOSTADDR
    newinfo.hostaddrsize and newinfo.hostaddr
DLPCMD_MODNSFLAG_NETMASK
    newinfo.hostnetmasksize and newinfo.hostnetmask

RETURN VALUE
These functions return 0 if successful, or a negative value otherwise.

SEE ALSO
libpconn(3).