man3tcp/BldSendChan

Table of Contents

Name

BldSendChan - create a client side tcp connection

Description

BldSendChan creates a client side tcp connection.

This function is part of libtcp.

Syntax

int BldSendChan(
   char *Hn,

   char *Sn,

   char *Sc,

   int default_port,

   int verbosity

   );

Arguments

Hn

Host name from /etc/hosts or dns lookup. This may also be specified as an IP address. If the argument is NULL, localhost will be used.

Sn

Service name from /etc/services. This may also be specified as a port number in which case no lookup is performed.

Sc

Service class from /etc/services.

This may be a NULL pointer. If it is then getservbyname() will return the first available entry.

Usually we specify this as "tcp" because this all AccelNET connections are "tcp" class and we aren’t interested in other classes such as "udp".

See the getservbyname() man page for more information.

default_port

Default port number to use if /etc/services lookup fails.

verbosity

Control the printing of messages generated by BldSendChan(). All messages are printed to stderr.

0 = suppress all messages

1 = suppress the connection open msg, print other messages

2 = print all messages

Returns

File descriptor of socket if successful. ERRconn on most other failures.

See Also

libtcp(3tcp)

Manual page revision

$Id: BldSendChan.3,v 1.6 2008/09/15 15:04:41 kitchen Exp $

Table of Contents