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

FreeBSD Manual Pages


home | help
SP_CONNECT(3)			 User Manuals			 SP_CONNECT(3)

       SP_connect - Connect an application to a	daemon

       #include	<sp.h>
       int  SP_connect(	const char *spread_name, const char *private_name, int
       priority, int group_membership, mailbox *mbox, char *private_group);

       SP_connect is the initial call an application must make to establish  a
       connection  with	a Spread daemon.  All other spread calls must refer to
       a valid mbox returned by	this function.

       The spread_name is the name of the Spread daemon	 to  connect  to.   It
       should be a string in one of the	following forms:

	      4803   This  will	 connect to the	Spread daemon on the local ma-
		     chine running on port 4803.  This form cannot be used  to
		     connect to	a Windows95/NT machine.

		     This  will	also connect to	the Spread daemon on the local
		     machine running on	port 4803.  This form can be  used  on
		     Windows95/NT machines. or 4803@
		     This will connect to the machine identified by either do-
		     main name or IP address at	the specified port.

       The private_name	is the name this connection would like to be known as.
       It  must	 be unique on the machine running the spread daemon.  The name
       can be of at most MAX_PRIVATE_NAME characters, with the same  character
       restrictions  as	a group	name (mainly it	cannot contain the '#' charac-
       ter). If	the application	does not care what name	it uses, it  can  pass
       in  a  NULL pointer into	this field and the daemon will assign the con-
       nection a unique, random	name.

       The priority is a 0/1 flag for whether this connection will be a	 "Pri-
       ority" connection or not. Currently this	has no effect.

       The  group_membership  is a boolean integer.  If	1 then the application
       will receive group membership messages for this connection, if  0  then
       the application will not	receive	any membership change messages.

       The  mbox should	be a pointer to	a mailbox variable.  After the SP_con-
       nect call returns this variable will hold the mbox for the connection.

       The private_group should	be a pointer to	a string big enough to hold at
       least  MAX_GROUP_NAME  characters.   After  the Connect call returns it
       will contain the	private	group name of  this  connection.   This	 group
       name can	be used	to send	unicast	messages to this connection and	no one
       can join	this special group.

       Returns ACCEPT_SESSION on success or one	of the following errors	( <  0

	       The  spread_name	 given to connect to was illegal for some rea-
	       son. Usually because it was a unix socket on  Windows95/NT,  an
	       improper	format for a host or an	illegal	port number

	       Lower  level  socket  calls failed to allow a connection	to the
	       specified spread	daemon right now.

	       During communication to establish the connection	errors occured
	       and the setup could not be completed.

	       The daemon or library has a version mismatch.

	       This  is	a protocol error which should not occur	if the connec-
	       tion request is sent correctly to the daemon. It	means that the
	       length  of  the user name was not sent (if no user name is pro-
	       vided a length of 0 must	be sent).

	       Name provided violated some requirement (length or used an  il-
	       legal character)

	       Name  provided  is  not	unique on this daemon. Recommended re-
	       sponse is to try	again with a different name.


       Yair Amir <>
       Jonathan	Stanton	<>


SPREAD				   JULY	1998			 SP_CONNECT(3)


Want to link to this manual page? Use this URL:

home | help