From 81fceb37a95304786f88f6611289a27c7262d394 Mon Sep 17 00:00:00 2001 From: archie Date: Tue, 30 Nov 1999 02:45:32 +0000 Subject: Add two new generic control messages, NGM_ASCII2BINARY and NGM_BINARY2ASCII, which convert control messages to ASCII and back. This allows control messages to be sent and received in ASCII form using ngctl(8), which makes ngctl a lot more useful. This also allows all the type-specific debugging code in libnetgraph to go away -- instead, we just ask the node itself to do the ASCII translation for us. Currently, all generic control messages are supported, as well as messages associated with the following node types: async, cisco, ksocket, and ppp. See /usr/share/examples/netgraph/ngctl for an example of using this. Also give ngctl(8) the ability to print out incoming data and control messages at any time. Eventually nghook(8) may be subsumed. Several other misc. bug fixes. Reviewed by: julian --- usr.sbin/ngctl/ngctl.8 | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) (limited to 'usr.sbin/ngctl/ngctl.8') diff --git a/usr.sbin/ngctl/ngctl.8 b/usr.sbin/ngctl/ngctl.8 index 8537d76..44b5402 100644 --- a/usr.sbin/ngctl/ngctl.8 +++ b/usr.sbin/ngctl/ngctl.8 @@ -60,11 +60,15 @@ will enter interactive mode. Otherwise .Nm ngctl will execute the supplied command(s) and exit immediately. .Pp -If the -.Dv ng_socket.ko -module is not installed in the kernel, -.Nm ngctl -will attempt to install it. +Nodes can be created, removed, joined together, etc. +ASCII formatted control messages can be sent to any node if that node +supports binary/ASCII control message conversion. +.Pp +In interactive mode, +.Nm +will display any control messages and data packets received by the socket node. +In the case of control messages, the message arguments are displayed in ASCII +form if the originating node supports conversion. .Pp The options are as follows: .Bl -tag -width indent @@ -92,6 +96,7 @@ debug Get/set debugging verbosity level help Show command summary or get help on a command list Show information about all nodes mkpeer Create and connect a new node to an existing node +msg Send an ASCII formatted message to a node name Assign a name to a node read Read and execute commands from a file rmhook Disconnect a node's hook @@ -102,8 +107,9 @@ types Show all installed node types quit Exit program .Ed .Pp +Some commands have aliases, e.g., ``ls'' is the same as ``list''. The ``help'' command displays the available -commands, their usage, and a brief description. +commands, their usage and aliases, and a brief description. .Sh EXIT VALUE The .Nm @@ -117,5 +123,5 @@ Archie Cobbs .Sh HISTORY The .Em netgraph -system was designed and first implemented at Whistle Communications, Inc. -in a version FreeBSD 2.2 customized for the Whistle InterJet. +system was designed and first implemented at Whistle Communications, Inc. in +a version FreeBSD 2.2 customized for the Whistle InterJet. -- cgit v1.1