From 5f3d7cc64f6f71fff52166dd6488f2df0378375b Mon Sep 17 00:00:00 2001 From: brain Date: Wed, 25 May 2005 22:04:11 +0000 Subject: Changed documentation to add parameters git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@1523 e03df62e-2008-0410-955e-edbf42e46eb7 --- docs/module-doc/classircd__connector.html | 84 ++++++++++++++++++++++++++++--- 1 file changed, 77 insertions(+), 7 deletions(-) (limited to 'docs/module-doc/classircd__connector.html') diff --git a/docs/module-doc/classircd__connector.html b/docs/module-doc/classircd__connector.html index e57bf5159..047c68bdd 100644 --- a/docs/module-doc/classircd__connector.html +++ b/docs/module-doc/classircd__connector.html @@ -69,7 +69,7 @@ Inheritance diagram for ircd_connector:

 Close the connection by calling close() on its file descriptor This function call updates no other data.

bool AddBuffer (std::string a) - This method adds text to the ircd connection's buffer This buffer's maximum size is one megabyte, the method returning false if the buffer is full.

+ This method adds text to the ircd connection's buffer.

bool BufferIsComplete ()  This method returns true if the buffer contains at least one carriage return character, e.g.

@@ -87,7 +87,7 @@ Inheritance diagram for ircd_connector:

 This method returns the version string of the remote server.

bool AddWriteBuf (std::string data) - Adds data to the connection's sendQ to be flushed later Fails if there is an error pending on the connection.

+ Adds data to the connection's sendQ to be flushed later.

bool FlushWriteBuf ()  Flushes as much of the data from the buffer as possible, and advances the queue pointer to what is left.

@@ -221,8 +221,15 @@ Constructor clears the sendq and initialises the fd to -1.

-This method adds text to the ircd connection's buffer This buffer's maximum size is one megabyte, the method returning false if the buffer is full. +This method adds text to the ircd connection's buffer.

+

Parameters:
+ + +
a The text to add to the buffer up to a maximum size of 1MB
+
+This buffer's maximum size is one megabyte, the method returning false if the buffer is full.

+

Returns:
True on success, false if the buffer is full or the connection is down
@@ -252,8 +259,15 @@ This method adds text to the ircd connection's buffer This buffer's maximum size

-Adds data to the connection's sendQ to be flushed later Fails if there is an error pending on the connection. +Adds data to the connection's sendQ to be flushed later.

+

Parameters:
+ + +
data The data to add to the write buffer
+
+Fails if there is an error pending on the connection.

+

Returns:
True on success, false if the connection is down or the buffer is full

Referenced by serverrec::SendPacket(). @@ -286,7 +300,9 @@ Referenced by serverrec::Se

This method returns true if the buffer contains at least one carriage return character, e.g.

-one line can be read from the buffer successfully. +one line can be read from the buffer successfully.

+

Returns:
True if there is at least one complete line waiting to be processed
+

@@ -316,6 +332,7 @@ one line can be read from the buffer successfully.

Checks if the connection replied to its last ping, and if it did sends another and returns true, if not, returns false.

+

Returns:
True if the server is still replying to pings
@@ -408,6 +425,7 @@ Referenced by serverrec::Se

Flushes as much of the data from the buffer as possible, and advances the queue pointer to what is left.

+

Returns:
True if the flush succeeded, false if the connection is down

Referenced by serverrec::SendPacket(). @@ -440,6 +458,7 @@ Referenced by serverrec::Se

This method retrieves the first string from the tail end of the buffer and advances the tail end of the buffer past the returned string, in a similar manner to strtok().

+

Returns:
The first line of the buffer up to a carriage return
@@ -470,6 +489,7 @@ This method retrieves the first string from the tail end of the buffer and advan

Get the server description of this connection.

+

Returns:
The description (GECOS) of this connection
@@ -500,6 +520,7 @@ Get the server description of this connection.

Get the file descriptor associated with this connection.

+

Returns:
The file descriptor associated with this connection
@@ -530,6 +551,7 @@ Get the file descriptor associated with this connection.

Get the ip address (not servername) associated with this connection.

+

Returns:
The connections IP address in dotted decimal form
@@ -592,6 +614,7 @@ Referenced by serverrec::Se

Get the port number being used for this connection If the connection is outbound this will be the remote port otherwise it will be the local port, so it can always be gautanteed as open at the address given in GetServerIP().

+

Returns:
The port number of this connection
@@ -622,6 +645,7 @@ Get the port number being used for this connection If the connection is outbound

Get the state flags for this connection.

+

Returns:
The state flags associated with this connection

Referenced by IsRoutable(), and serverrec::SendPacket(). @@ -654,7 +678,9 @@ Referenced by IsRoutable()<

This method returns the version string of the remote server.

-If the server has no version string an empty string is returned. +If the server has no version string an empty string is returned.

+

Returns:
The version text of this connection
+

@@ -684,6 +710,7 @@ If the server has no version string an empty string is returned.

Gets the error string for this connection.

+

Returns:
The last error to occur or an empty string

Referenced by serverrec::SendPacket(). @@ -716,6 +743,7 @@ Referenced by serverrec::Se

Returns true if there is data to be written that hasn't been sent yet.

+

Returns:
True if the buffer is not empty
@@ -819,6 +847,11 @@ Resets the ping counter.

Set the server description of this connection.

+

Parameters:
+ + +
desc The description (GECOS) of this connection to be set
+
@@ -850,6 +883,11 @@ Set the server description of this connection.

Set the file descriptor for this connection.

+

Parameters:
+ + +
fd The file descriptor to associate with the connection
+

Referenced by serverrec::AddIncoming(). @@ -932,6 +970,13 @@ PRIVATE function to set the host address and port to connect to.

Set both the host and the port in one operation for this connection.

+

Parameters:
+ + + +
newhost The hostname to set for this connection
newport The port number to set for this connection
+
+
Returns:
True on success, false on failure

Referenced by serverrec::AddIncoming(), serverrec::BeginLink(), and serverrec::MeshCookie(). @@ -965,6 +1010,11 @@ Referenced by serverrec::Ad

Set the server name of this connection.

+

Parameters:
+ + +
serv The server name to set
+

Referenced by serverrec::AddIncoming(), serverrec::BeginLink(), and serverrec::MeshCookie(). @@ -998,6 +1048,11 @@ Referenced by serverrec::Ad

Set the port used by this connection.

+

Parameters:
+ + +
p The port number to set for this connection
+
@@ -1029,6 +1084,11 @@ Set the port used by this connection.

Set the state flags for this connection.

+

Parameters:
+ + +
state The state flags to set for this connection
+

Referenced by serverrec::AddIncoming(), serverrec::BeginLink(), serverrec::MeshCookie(), and serverrec::SendPacket(). @@ -1062,6 +1122,11 @@ Referenced by serverrec::Ad

This method sets the version string of the remote server.

+

Parameters:
+ + +
newversion The version string to set
+
@@ -1093,6 +1158,11 @@ This method sets the version string of the remote server.

Sets the error string for this connection.

+

Parameters:
+ + +
error The error string to set
+
@@ -1464,7 +1534,7 @@ Definition at line 94
The documentation for this class was generated from the following file: -
Generated on Wed May 25 21:43:19 2005 for InspIRCd by +
Generated on Wed May 25 22:03:11 2005 for InspIRCd by doxygen 1.3.3
-- cgit v1.2.3