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, respec

tively (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).

BSD Aug 16, 2001

BSD