This is another major rework of the 'net' command.

This time, all the existing functionality has been moved into
'net rap', ready for new commands in the 'net ads' and 'net rpc' categories.

In particular, we hope to have the abilty to autoselect the appropriate
backend to use based on smb.conf or other paramaters.

This will allow 'net user' to work no matter what the remote server.

The new 'net rpc' command will soon gain a 'net rpc join' and a
'net rpc user' based on the existing samba code.

Also in this commit, the connection establishment code has been almost entirly
reworked, and now has some minor sense of sainity to it.
In particular, we can now connect to hosts *other* than localhost!

We also have the ability to state on a per-command basis whether the 'localhost'
is a sane default value.  (A net join, for example, would not be sane against
localhost).

Unfortunetly we have had to make the basic paramaters global variables, but
the 'cli' is not opened and closed on a per-command basis.

Andrew Bartlett
(This used to be commit 8739d426caabe3794a018dd28ab139b08f88b603)

1 files changed, 1161 insertions, 0 deletions

diff --git a/source3/utils/net_rap.c b/source3/utils/net_rap.c
new file mode 100644
index 0000000000..41d2fa7ec1
--- /dev/null
+++ b/source3/utils/net_rap.c
@@ -0,0 +1,1161 @@
+/* 
+   Samba Unix/Linux SMB client library 
+   Version 3.0
+   Distributed SMB/CIFS Server Management Utility 
+   Copyright (C) 2001 Steve French  (sfrench@us.ibm.com)
+   Copyright (C) 2001 Jim McDonough (jmcd@us.ibm.com)
+   Copyright (C) 2001 Andrew Tridgell (tridge@samba.org)
+   Copyright (C) 2001 Andrew Bartlett (abartlet@samba.org)
+
+   Originally written by Steve and Jim. Largely rewritten by tridge in
+   November 2001.
+
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2 of the License, or
+   (at your option) any later version.
+   
+   This program is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+   
+   You should have received a copy of the GNU General Public License
+   along with this program; if not, write to the Free Software
+   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
+
+#include "includes.h"
+#include "../utils/net.h"
+
+#define FILE_INFO_DISPLAY \
+    "File ID          %d\n"\
+    "User name        %s\n"\
+    "Locks            0x%-4.2x\n"\
+    "Path             %s\n"\
+    "Permissions      0x%x\n"
+#define FILE_ENUM_DISPLAY \
+    "\nEnumerating open files on remote server:\n\n"\
+    "\n\tFileId  Opened by            Perms  Locks  Path \n"\
+    "\t------  ---------            -----  -----  ---- \n"
+
+#define RAP_SHARE_USAGE \
+    "\nnet rap share [misc. options] [targets] \n"\
+    "\tenumerates all exported resources (network shares) on target server\n"\
+    "\nnet rap share ADD <name=serverpath> [misc. options] [targets]"\
+    "\n\tAdd a share from a server (makes the export active)\n"\
+    "\nnet rap share DELETE <sharename> [misc. options] [targets]\n"\
+    "\tor"\
+    "\nnet rap share CLOSE <sharename> [misc. options] [targets]"\
+    "\n\tDeletes a share from a server (makes the export inactive)\n"
+    
+#define SHARE_ENUM_DISPLAY \
+    "\nEnumerating shared resources (exports) on remote server:\n\n"\
+    "\nShare name   Type     Description\n"\
+    "----------   ----     -----------\n"
+
+
+#define RAP_SESSION_USAGE \
+    "\nnet rap session [misc. options] [targets]"\
+    "\n\tenumerates all active SMB/CIFS sessions on target server\n"\
+    "\nnet rap session DELETE <client_name> [misc. options] [targets] \n"\
+    "\tor"\
+    "\nnet rap session CLOSE <client_name> [misc. options] [targets]"\
+    "\n\tDeletes (closes) a session from specified client to server\n"
+
+#define SESSION_ENUM_DISPLAY \
+    "Computer             User name            Client Type        Opens Idle time\n\n"\
+    "------------------------------------------------------------------------------\n"
+
+
+#define SESSION_DISPLAY_ONE \
+    
+
+#define SESSION_DISPLAY_CONNS \
+    "Share name     Type     # Opens\n"\
+    "------------------------------------------------------------------------------\n"
+
+#define RAP_SERVER_USAGE \
+    "\nUsage:\n"\
+    "  net rap server [domain]\tlists the servers in the specified domain or workgroup.\n"\
+    "    If domain is not specified, it uses the current domain or workgroup as\n"\
+    "    the default.\n"
+
+#define SERVER_ENUM_DISPLAY "\nEnumerating servers in this domain or workgroup: \n\n"  \
+    "\n\tServer name          Server description\n"\
+    "\t-------------        ----------------------------\n"
+
+
+#define RAP_DOMAIN_USAGE \
+    "\nUsage:\n"\
+    "  net rap domain [misc. options] [target]\n\tlists the domains "\
+    "or workgroups visible on the current network\n"
+
+#define DOMAIN_ENUM_DISPLAY \
+    "\nEnumerating domains:\n\n"\
+    "\n\tDomain name          Server name of Browse Master\n"\
+    "\t-------------        ----------------------------\n"
+
+#define RAP_PRINTQ_USAGE \
+    "\nUsage:\n"\
+    " net rap printq [misc. options] [targets]\n"\
+    "\tor\n"\
+    " net rap printq list [<queue_name>] [misc. options] [targets]\n"\
+    "\tlists the specified queue and jobs on the target server.\n"\
+    "\tIf the queue name is not specified, all queues are listed.\n\n"\
+    " net rap printq delete [<queue name>] [misc. options] [targets]\n"\
+    "\tdeletes the specified job number on the target server, or the\n"\
+    "\tprinter queue if no job number is specified\n"
+#define PRINTQ_ENUM_DISPLAY \
+    "Print queues at \\\\%s\n\n"\
+    "Name                         Job #      Size            Status\n\n"\
+    "------------------------------------------------------------------"\
+    "-------------\n"
+#define PRINTQ_DISPLAY_ONE "%-23.23s %5d jobs                      %-22.22s\n"
+#define PRINTQ_PRINTER_ACTIVE "*Printer Active*"
+#define PRINTQ_PRINTER_PAUSED "*Printer Paused*"
+#define PRINTQ_PRINTER_ERROR "*Printer error*"
+#define PRINTQ_PRINTER_DELPEND "*Delete Pending*"
+#define PRINTQ_PRINTER_STATUNK "**UNKNOWN STATUS**"
+#define PRINTQ_DISPLAY_JOB "     %-23.23s %5d %9d            %-22.22s\n"
+#define PRINTQ_JOB_PRINTING "Printing"
+#define PRINTQ_JOB_QUEUED "Waiting"
+#define PRINTQ_JOB_PAUSED "Held in queue"
+#define PRINTQ_JOB_SPOOLING "Spooling"
+#define PRINTQ_QUEUE_WORD " Queue"
+
+#define RAP_USER_USAGE \
+    "\nnet rap user [misc. options] [targets]\n\tEnumerate users\n"\
+    "\nnet rap user DELETE <name> [misc. options] [targets]"\
+    "\n\tDelete specified user\n"\
+    "\nnet rap user INFO <name> [misc. options] [targets]"\
+    "\n\tList the domain groups of the specified user\n"\
+    "\nnet rap user ADD <name> [-F user flags] [misc. options] [targets]"\
+    "\n\tAdd specified user\n"
+
+#define USER_ENUM_DISPLAY \
+    "\nEnumerating shared resources (exports) on remote server:\n\n"\
+    "\nUser name             Description                                     Home Directory                          Profile Directory\n"\
+    "---------             -----------                                     --------------                          -----------------\n"
+
+#define RAP_GROUP_USAGE \
+    "net rap group [misc. options] [targets]"\
+    "\n\tEnumerate user groups\n"\
+    "\nnet rap group DELETE <name> [misc. options] [targets]"\
+    "\n\tDelete specified group\n"\
+    "\nnet rap group ADD <name> [-C comment] [misc. options] [targets]"\
+    "\n\tCreate specified group\n"
+
+#define RAP_GROUPMEMBER_USAGE \
+    "net rap groupmember LIST <group name> [misc. options] [targets]"\
+    "\n\t Enumerate users in a group\n"\
+    "\nnet rap groupmember DELETE <group name> <user name> [misc. options] "\
+    "[targets]\n\t Delete sepcified user from specified group\n"\
+    "\nnet rap groupmember ADD <group name> <user name> [misc. options] [targets]"\
+    "\n\t Add specified user to specified group\n"
+
+            
+#define RAP_SERVICE_USAGE \
+    "net rap service [misc. options] [targets] \n"\
+    "\tenumerates all running service daemons on target server\n"\
+    "\nnet rap service ADD <name> [service startup arguments] [misc. options] [targets]"\
+    "\n\tStart named service on remote server\n"\
+    "\nnet rap service DELETE <name> [misc. options] [targets]\n"\
+    "\n\tStop named service on remote server\n"
+    
+
+#define RAP_VALIDATE_USAGE \
+    "net rap validate <username> [password]\n"\
+    "\tValidate user and password to check whether they can access target server or domain\n"
+
+#define GLBL_LCL_MASTER   "global browsemaster or local browse master if that is not found"
+#define DOMAIN_MASTER     "local domain browse master"
+
+#define ERRMSG_NOCONN_TARGET_SRVR	
+#define ERRMSG_NOCONN_BROWSE_MSTR	"\nUnable to connect to browse master\n"
+#define ERRMSG_NOT_IMPLEMENTED		"\nNot implemented\n"
+#define ERRMSG_FILEID_MISSING		"\nMissing fileid of file to close\n\n"
+#define ERRMSG_GROUPNAME_MISSING        "\n\nGroup name not specified\n"
+#define ERRMSG_USERNAME_MISSING        "\n\nUser name not specified\n"
+#define ERRMSG_SHARENAME_MISSING        "\n\nShare name not specified\n"
+#define ERRMSG_TARGET_WG_NOT_VALID      "\nTarget workgroup option not valid "\
+					"except on net rap server command, ignored"
+#define ERRMSG_INVALID_HELP_OPTION	"\nInvalid help option\n"
+
+#define ERRMSG_SPURIOUS_PARM            "\nInvalid paramater ignored: %s\n"
+#define ERRMSG_BOTH_SERVER_IPADDRESS    "\nTarget server and IP address both "\
+  "specified. Do not set both at the same time.  The target IP address was used\n"
+
+/* Column headers */
+#define COMMENT_STR   "Comment "
+#define USER_STR      "User name "
+#define GROUP_STR     "Group name "  
+#define SERVICE_STR   "Service name"
+#define HOMED_STR     "Home directory "
+#define LOGONS_STR    "Logon script "
+
+#define PORT_USAGE        "\t-p or --port=<port number>\tconnection port on target server\n"
+#define WORKGROUP_USAGE   "\t-w or --workgroup=<wg>\t\ttarget workgroup or domain name\n"
+#define COMMENT_USAGE     "\t-C or --comment=<comment>\tdescriptive comment (for add only)\n"
+#define MYWORKGROUP_USAGE "\t-W or --myworkgroup=<wg>\tclient workgroup\n"
+#define DEBUG_USAGE       "\t-d or --debug=<level>\t\tdebug level (0-10)\n"
+#define MYNAME_USAGE      "\t-n or --myname=<name>\t\tclient name\n"
+#define USER_USAGE        "\t-U or --user=<name>\t\tuser name\n"
+#define CONF_USAGE        "\t-s or --conf=<path>\t\tpathname of smb.conf file\n"
+#define JOBID_USAGE       "\t-j or --jobid=<job id>\t\tjob id\n"
+#define MAXUSERS_USAGE    "\t-M or --maxusers=<num>\t\tmax users allowed for share\n"
+#define LONG_USAGE        "\t-l or --long\t\t\tDisplay full information\n"
+
+static const char *share_type[] = {
+  "Disk",
+  "Print",
+  "Dev",
+  "IPC"
+};
+
+/* End of weild 'strings at top of file' section */
+static int general_rap_usage(int argc, const char **argv)
+{
+
+	d_printf("Valid targets: choose one (none defaults to using localhost)\n");
+	d_printf("\t-S or --server=<server>\t\tserver name\n");
+	d_printf("\t-I or --ipaddress=<ipaddr>\tip address of target server\n");
+
+	d_printf("\n");
+	d_printf("Valid miscellaneous options are:\n"); /* misc options */
+	d_printf(PORT_USAGE);
+	d_printf(MYWORKGROUP_USAGE);
+	d_printf(DEBUG_USAGE);
+	d_printf(MYNAME_USAGE);
+	d_printf(USER_USAGE);
+	d_printf(CONF_USAGE);
+	return -1;
+}
+
+
+static int file_usage(int argc, const char **argv)
+{
+	d_printf("net rap file [misc. options] [targets]\n"\
+	"\tenumerates all open files on file server\n\n");
+
+	d_printf("net rap file USER <username> [misc. options] [targets]\n"\
+		 "\tenumerates all files opened by username on file server\n\n");
+	d_printf("net rap file CLOSE <id> [misc. options] [targets]\n"\
+		 "\tcloses specified file on target server\n");
+
+	general_rap_usage(argc, argv);
+	return -1;
+}
+
+/***************************************************************************
+  list info on an open file
+***************************************************************************/
+static void file_fn(const char * pPath, const char * pUser, uint16 perms, 
+		    uint16 locks, uint32 id)
+{
+	d_printf("\t%-7.1d %-20.20s 0x%-4.2x %-6.1d %s\n",
+		 id, pUser, perms, locks, pPath);
+}
+
+static void one_file_fn(const char *pPath, const char *pUser, uint16 perms, 
+			uint16 locks, uint32 id)
+{
+	d_printf(FILE_INFO_DISPLAY, id, pUser, locks, pPath, perms);
+}
+
+
+static int rap_file_close(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	if (argc == 0)
+		return file_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	ret = cli_NetFileClose(cli, atoi(argv[0]));
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_file_info(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	if (argc == 0)
+		return file_usage(argc, argv);
+	
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	ret = cli_NetFileGetInfo(cli, atoi(argv[0]), one_file_fn);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_file_user(int argc, const char **argv)
+{
+	if (argc == 0)
+		return file_usage(argc, argv);
+
+	d_printf("net rap file user not implemented yet\n");
+	return -1;
+}
+
+static int rap_file(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"CLOSE", rap_file_close},
+		{"USER", rap_file_user},
+		{"INFO", rap_file_info},
+		{NULL, NULL}
+	};
+	
+	if (argc == 0) {
+		struct cli_state *cli;
+		int ret;
+		
+		if (!(cli = net_make_ipc_connection(0))) 
+                        return -1;
+
+		/* list open files */
+		d_printf(FILE_ENUM_DISPLAY); /* file list header */
+		ret = cli_NetFileEnum(cli, NULL, NULL, file_fn);
+		cli_shutdown(cli);
+		return ret;
+	}
+	
+	return net_run_function(argc, argv, func, file_usage);
+}
+		       
+static int share_usage(int argc, const char **argv)
+{
+	d_printf(RAP_SHARE_USAGE); /* command syntax */
+	return -1;
+}
+
+static void long_share_fn(const char *share_name, uint32 type, const char *comment, void *state)
+{
+	d_printf("%-12.12s %-8.8s %-50.50s\n", share_name, share_type[type], comment);
+}
+
+static void share_fn(const char *share_name, uint32 type, const char *comment, void *state)
+{
+	d_printf("%-12.12s\n", share_name);
+}
+
+static int rap_share_delete(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (argc == 0) {
+		d_printf(ERRMSG_SHARENAME_MISSING);
+		return -1;
+	}
+
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	ret = cli_NetShareDelete(cli, argv[0]);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_share_add(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	RAP_SHARE_INFO_2 sinfo;
+	char *p;
+	char *sharename;
+
+	if (argc == 0) {
+		d_printf(ERRMSG_SHARENAME_MISSING);
+		return -1;
+	}
+			
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	sharename = strdup(argv[0]);
+	p = strchr(sharename, '=');
+	*p = 0;
+	strlcpy(sinfo.share_name, sharename, sizeof(sinfo.share_name));
+	sinfo.reserved1 = '\0';
+	sinfo.share_type = 0;
+	sinfo.comment = opt_comment;
+	sinfo.perms = 0;
+	sinfo.maximum_users = opt_maxusers;
+	sinfo.active_users = 0;
+	sinfo.path = p+1;
+	memset(sinfo.password, '\0', sizeof(sinfo.password));
+	sinfo.reserved2 = '\0';
+	
+	ret = cli_NetShareAdd(cli, &sinfo);
+	cli_shutdown(cli);
+	return ret;
+}
+
+
+static int rap_share(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"DELETE", rap_share_delete},
+		{"CLOSE", rap_share_delete},
+		{"ADD", rap_share_add},
+		{NULL, NULL}
+	};
+
+	if (argc == 0) {
+		struct cli_state *cli;
+		int ret;
+		
+		if (!(cli = net_make_ipc_connection(0))) 
+			return -1;
+		
+		if (opt_long_list_entries) {
+			d_printf(SHARE_ENUM_DISPLAY);
+			ret = cli_RNetShareEnum(cli, long_share_fn, NULL);
+		}
+		ret = cli_RNetShareEnum(cli, share_fn, NULL);
+		cli_shutdown(cli);
+		return ret;
+	}
+
+	return net_run_function(argc, argv, func, share_usage);
+}
+		    
+		
+static int session_usage(int argc, const char **argv)
+{
+	d_printf(RAP_SESSION_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}
+    
+static void list_sessions_func(char *wsname, char *username, uint16 conns,
+			uint16 opens, uint16 users, uint32 sess_time,
+			uint32 idle_time, uint32 user_flags, char *clitype)
+{
+	int hrs = idle_time / 3600;
+	int min = (idle_time / 60) % 60;
+	int sec = idle_time % 60;
+	
+	d_printf("\\\\%-18.18s %-20.20s %-18.18s %5d %2.2d:%2.2d:%2.2d\n",
+		 wsname, username, clitype, opens, hrs, min, sec);
+}
+
+static void display_session_func(const char *wsname, const char *username, uint16 conns,
+				 uint16 opens, uint16 users, uint32 sess_time,
+				 uint32 idle_time, uint32 user_flags, const char *clitype)
+{
+	int ihrs = idle_time / 3600;
+	int imin = (idle_time / 60) % 60;
+	int isec = idle_time % 60;
+	int shrs = sess_time / 3600;
+	int smin = (sess_time / 60) % 60;
+	int ssec = sess_time % 60;
+	d_printf("User name       %-20.20s\n"\
+		 "Computer        %-20.20s\n"\
+		 "Guest logon     %-20.20s\n"\
+		 "Client Type     %-40.40s\n"\
+		 "Sess time       %2.2d:%2.2d:%2.2d\n"\
+		 "Idle time       %2.2d:%2.2d:%2.2d\n", 
+		 username, wsname, 
+		 (user_flags&0x0)?"yes":"no", clitype,
+		 shrs, smin, ssec, ihrs, imin, isec);
+}
+
+static void display_conns_func(uint16 conn_id, uint16 conn_type, uint16 opens, uint16 users, uint32 conn_time, const char *username, const char *netname)
+{
+	d_printf("%-14.14s %-8.8s %5d\n", netname, share_type[conn_type], opens);
+}
+
+static int rap_session_info(int argc, const char **argv)
+{
+	const char *sessname;
+	struct cli_state *cli;
+	int ret;
+	
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	if (argc == 0) 
+                return session_usage(argc, argv);
+
+	sessname = argv[0];
+
+	ret = cli_NetSessionGetInfo(cli, sessname, display_session_func);
+	if (ret < 0) {
+		cli_shutdown(cli);
+                return ret;
+	}
+
+	d_printf(SESSION_DISPLAY_CONNS);
+
+	ret = cli_NetConnectionEnum(cli, sessname, display_conns_func);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_session_delete(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	if (argc == 0) 
+                return session_usage(argc, argv);
+
+	ret = cli_NetSessionDel(cli, argv[0]);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_session(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"INFO", rap_session_info},
+		{"DELETE", rap_session_delete},
+		{"CLOSE", rap_session_delete},
+		{NULL, NULL}
+	};
+
+	if (argc == 0) {
+		struct cli_state *cli;
+		int ret;
+		
+		if (!(cli = net_make_ipc_connection(0))) 
+			return -1;
+
+		ret = cli_NetSessionEnum(cli, list_sessions_func);
+
+		cli_shutdown(cli);
+		return ret;
+	}
+
+	return net_run_function(argc, argv, func, session_usage);
+}
+	
+/****************************************************************************
+list a server name
+****************************************************************************/
+static void display_server_func(const char *name, uint32 m, const char *comment, void * reserved)
+{
+	d_printf("\t%-16.16s     %s\n", name, comment);
+}
+
+
+static int server_usage(int argc, const char **argv)
+{
+	d_printf(RAP_SERVER_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}
+		    
+static int rap_server(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	d_printf(SERVER_ENUM_DISPLAY); /* header for list of servers */
+	ret = cli_NetServerEnum(cli, cli->server_domain, SV_TYPE_ALL, display_server_func,NULL); 
+	cli_shutdown(cli);
+	return ret;	
+}
+		      
+static int domain_usage(int argc, const char **argv)
+{
+	d_printf(RAP_DOMAIN_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}
+
+		  
+static int rap_domain(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	d_printf(DOMAIN_ENUM_DISPLAY); /* header for list of domains */
+	ret = cli_NetServerEnum(cli, cli->server_domain, SV_TYPE_DOMAIN_ENUM, display_server_func,NULL);	
+	cli_shutdown(cli);
+	return ret;	
+}
+		      
+static int printq_usage(int argc, const char **argv)
+{
+	d_printf(RAP_PRINTQ_USAGE);
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}	
+
+static void enum_queue(const char *queuename, uint16 pri, uint16 start, uint16 until, 
+		       const char *sep, const char *pproc, const char *dest, 
+		       const char *qparms, const char *qcomment, uint16 status, 
+		       uint16 jobcount) {
+	pstring queuecol;
+	pstring statcol;
+
+	pstrcpy(queuecol, queuename);
+	pstrcat(queuecol, PRINTQ_QUEUE_WORD);
+	
+	switch (status) {
+	case 0:
+		pstrcpy(statcol, PRINTQ_PRINTER_ACTIVE);
+		break;
+	case 1:
+		pstrcpy(statcol, PRINTQ_PRINTER_PAUSED);
+		break;
+	case 2:
+		pstrcpy(statcol, PRINTQ_PRINTER_ERROR);
+		break;
+	case 3:
+		pstrcpy(statcol, PRINTQ_PRINTER_DELPEND);
+		break;
+	default:
+		pstrcpy(statcol, PRINTQ_PRINTER_STATUNK);
+	}
+	d_printf(PRINTQ_DISPLAY_ONE, queuecol, jobcount, statcol);
+}
+
+static void enum_jobs(uint16 jobid, const char *ownername, const char *notifyname, 
+		      const char *datatype, const char *jparms, uint16 pos, 
+		      uint16 status, const char *jstatus, uint submitted, uint jobsize, 
+		      const char *comment) {
+	pstring statcol;
+
+	switch (status) {
+	case 0:
+		pstrcpy(statcol, PRINTQ_JOB_QUEUED);
+		break;
+	case 1:
+		pstrcpy(statcol, PRINTQ_JOB_PAUSED);
+		break;
+	case 2:
+		pstrcpy(statcol, PRINTQ_JOB_SPOOLING);
+		break;
+	case 3:
+		pstrcpy(statcol, PRINTQ_JOB_PRINTING);
+		break;
+	default:
+		pstrcpy(statcol, PRINTQ_PRINTER_STATUNK);
+	}
+	d_printf(PRINTQ_DISPLAY_JOB, ownername, jobid, jobsize, statcol);
+}
+
+static int rap_printq_info(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (argc == 0) 
+                return printq_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	ret = cli_NetPrintQGetInfo(cli, argv[0], enum_queue, enum_jobs);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_printq_delete(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (argc == 0) 
+                return printq_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	ret = cli_printjob_del(cli, atoi(argv[0]));
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_printq(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	struct functable func[] = {
+		{"INFO", rap_printq_info},
+		{"DELETE", rap_printq_delete},
+		{NULL, NULL}
+	};
+
+	if (argc == 0) {
+		if (!(cli = net_make_ipc_connection(0))) 
+			return -1;
+
+		ret = cli_NetPrintQEnum(cli, enum_queue, enum_jobs);
+		cli_shutdown(cli);
+		return ret;
+	}
+
+	return net_run_function(argc, argv, func, printq_usage);
+}
+
+	
+static int user_usage(int argc, const char **argv)
+{
+	d_printf(RAP_USER_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+} 
+	
+static void user_fn(const char *user_name, const char *comment, const char * home_dir, 
+		    const char * logon_script, void *state)
+{
+	d_printf("%-21.21s\n", user_name);
+}
+
+static void long_user_fn(const char *user_name, const char *comment, const char * home_dir, const char * logon_script, void *state)
+{
+	d_printf("%-21.21s %-47.47s %-35.35s %35.35s\n", user_name, comment, home_dir, logon_script);
+}
+
+static void group_member_fn(const char *user_name, void *state)
+{
+	d_printf("%-21.21s\n", user_name);
+}
+
+static int rap_user_delete(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (argc == 0) 
+                return user_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	ret = cli_NetUserDelete(cli, argv[0]);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_user_add(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	RAP_USER_INFO_1 userinfo;
+
+	if (argc == 0) 
+                return user_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0)))
+                return -1;
+			
+	safe_strcpy(userinfo.user_name, argv[0], sizeof(userinfo.user_name));
+	if (opt_flags == -1) 
+                opt_flags = 0x21; 
+			
+	userinfo.userflags = opt_flags;
+	userinfo.reserved1 = '\0';
+	userinfo.comment = opt_comment;
+	userinfo.priv = 1; 
+	userinfo.home_dir = NULL;
+	userinfo.logon_script = NULL;
+	
+	ret = cli_NetUserAdd(cli, &userinfo);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_user_info(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	if (argc == 0) 
+                return user_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0)))
+                return -1;
+
+	ret = cli_NetUserGetGroups(cli, argv[0], group_member_fn, NULL);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_user(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"ADD", rap_user_add},
+		{"INFO", rap_user_info},
+		{"DELETE", rap_user_delete},
+		{NULL, NULL}
+	};
+
+	if (argc == 0) {
+		struct cli_state *cli;
+		int ret;
+		if (!(cli = net_make_ipc_connection(0)))
+                        return -1;
+		if (opt_long_list_entries) {
+			d_printf(USER_ENUM_DISPLAY);
+			ret = cli_RNetUserEnum(cli, long_user_fn, NULL);
+			cli_shutdown(cli);
+			return ret;
+		}
+		ret = cli_RNetUserEnum(cli, user_fn, NULL); 
+		cli_shutdown(cli);
+		return ret;
+	}
+
+	return net_run_function(argc, argv, func, user_usage);
+}
+
+
+static int group_usage(int argc, const char **argv)
+{
+	d_printf(RAP_GROUP_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}
+
+static void long_group_fn(const char *group_name, const char *comment, void *state)
+{
+	d_printf("%-21.21s %-50.50s\n", group_name, comment);
+}
+
+static void group_fn(const char *group_name, const char *comment, void *state)
+{
+	d_printf("%-21.21s\n", group_name);
+}
+
+static int rap_group_delete(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	if (argc == 0) 
+                return group_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0)))
+                return -1;
+
+	ret = cli_NetGroupDelete(cli, argv[0]);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_group_add(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	RAP_GROUP_INFO_1 grinfo;
+
+	if (argc == 0) 
+                return group_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0)))
+                return -1;
+			
+	/* BB check for length 21 or smaller explicitly ? BB */
+	safe_strcpy(grinfo.group_name, argv[0], sizeof(grinfo.group_name));
+	grinfo.reserved1 = '\0';
+	grinfo.comment = opt_comment;
+	
+	ret = cli_NetGroupAdd(cli, &grinfo);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_group(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"ADD", rap_group_add},
+		{"DELETE", rap_group_delete},
+		{NULL, NULL}
+	};
+
+	if (argc == 0) {
+		struct cli_state *cli;
+		int ret;
+		if (!(cli = net_make_ipc_connection(0)))
+                        return -1;
+		if (opt_long_list_entries) {
+			d_printf("%-21.21s %-50.50s\n", GROUP_STR, COMMENT_STR); 
+			d_printf("-----------------------------\n");
+			ret = cli_RNetGroupEnum(cli, long_group_fn, NULL);
+			cli_shutdown(cli);
+			return ret;
+		}
+		ret = cli_RNetGroupEnum(cli, group_fn, NULL); 
+		cli_shutdown(cli);
+		return ret;
+	}
+
+	return net_run_function(argc, argv, func, group_usage);
+}
+
+static int groupmember_usage(int argc, const char **argv)
+{
+	d_printf(RAP_GROUPMEMBER_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}
+
+
+static int rap_groupmember_add(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	if (argc != 2) 
+                return groupmember_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0)))
+                return -1;
+
+	ret = cli_NetGroupAddUser(cli, argv[0], argv[1]);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_groupmember_delete(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	if (argc != 2) 
+                return groupmember_usage(argc, argv);
+	
+	if (!(cli = net_make_ipc_connection(0)))
+                return -1;
+
+	ret = cli_NetGroupDelUser(cli, argv[0], argv[1]);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_groupmember_list(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	if (argc == 0) 
+                return groupmember_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0)))
+                return -1;
+
+	ret = cli_NetGroupGetUsers(cli, argv[0], group_member_fn, NULL ); 
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int rap_groupmember(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"ADD", rap_groupmember_add},
+		{"LIST", rap_groupmember_list},
+		{"DELETE", rap_groupmember_delete},
+		{NULL, NULL}
+	};
+	
+	return net_run_function(argc, argv, func, groupmember_usage);
+}
+
+static int validate_usage(int argc, const char **argv)
+{
+	d_printf(RAP_VALIDATE_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}
+
+static int rap_validate(int argc, const char **argv)
+{
+	d_printf(ERRMSG_NOT_IMPLEMENTED);
+	return 0;
+}
+
+static int service_usage(int argc, const char **argv)
+{
+	d_printf(RAP_SERVICE_USAGE); /* command syntax */
+	
+	general_rap_usage(argc, argv);
+	return -1;
+}
+
+static int rap_service_add(int argc, const char **argv)
+{
+	d_printf(ERRMSG_NOT_IMPLEMENTED);
+	return 0;
+}
+
+static int rap_service_delete(int argc, const char **argv)
+{
+	d_printf(ERRMSG_NOT_IMPLEMENTED);
+	return 0;
+}
+
+static int rap_service(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"ADD", rap_service_add},
+		{"DELETE", rap_service_delete},
+		{NULL, NULL}
+	};
+
+	if (argc == 0) {
+		struct cli_state *cli;
+		int ret;
+		if (!(cli = net_make_ipc_connection(0))) 
+			return -1;
+
+		if (opt_long_list_entries) {
+			d_printf("%-15.15s %-50.50s\n", SERVICE_STR, COMMENT_STR); 
+			d_printf("-----------------------------\n");
+			ret = cli_RNetServiceEnum(cli, long_group_fn, NULL);
+		}
+		ret = cli_RNetServiceEnum(cli, group_fn, NULL); 
+		cli_shutdown(cli);
+		return ret;
+	}
+
+	return net_run_function(argc, argv, func, service_usage);
+}
+
+static int password_usage(int argc, const char **argv)
+{
+	d_printf("net rap password <user> <old password> <new password> [misc_options] [targets]\n");
+	d_printf("\tchanges the password for the specified user on a remote server\n"); 
+	
+	return -1;
+}
+
+
+static int rap_password(int argc, const char **argv)
+{
+	struct cli_state *cli;
+	int ret;
+	
+	if (argc < 3) 
+                return password_usage(argc, argv);
+
+	if (!(cli = net_make_ipc_connection(0))) 
+                return -1;
+
+	/* BB Add check for password lengths? */
+	ret = cli_oem_change_password(cli, argv[0], argv[2], argv[1]);
+	cli_shutdown(cli);
+	return ret;
+}
+
+static int admin_usage(int argc, const char **argv)
+{
+	d_printf("net rap admin <remote command to execute> [cmd arguments [environment]] [misc_options] [targets]\n");
+	d_printf("\texecutes a remote command on an os/2 target server\n"); 
+	
+	return -1;
+}
+
+
+static int rap_admin(int argc, const char **argv)
+{
+	d_printf(ERRMSG_NOT_IMPLEMENTED);
+	return 0;
+}
+
+/* The help subsystem for the RAP subcommand */
+
+int net_rap_usage(int argc, const char **argv)
+{
+	d_printf("  net rap domain \tto list domains \n"\
+		 "  net rap file \tto list open files on a server \n"\
+		 "  net rap group \tto list user groups  \n"\
+		 "  net rap groupmember to list users in a group \n"\
+		 "  net rap password\t to change the password of a user\n"\
+		 "  net rap printq \tto list the print queues on a server\n"\
+		 "  net rap server \tto list servers in a domain\n"\
+		 "  net rap session \tto list clients with open sessions to a server\n"\
+		 "  net rap share \tto list shares exported by a server\n"\
+		 "  net rap user \tto list users\n"\
+		 "  net rap validate \tto check whether a user and the corresponding password are valid\n"\
+		 "  net rap help\n"\
+		 "\nType \"net help <option>\" to get more information on that option\n\n");
+
+	general_rap_usage(argc, argv);
+	return -1;
+}
+
+static int rap_help_usage(int argc, const char **argv)
+{
+	d_printf("\n"\
+"Usage: net rap help <function>\n"\
+"\n"\
+"Valid functions are:\n"\
+"  FILE SHARE SESSION SERVER DOMAIN PRINTQ USER GROUP\n"\
+"  VALIDATE GROUPMEMBER ADMIN SERVICE PASSWORD\n");
+	return -1;
+}
+
+/*
+  handle "net help *" subcommands
+*/
+static int rap_help(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"FILE", file_usage},
+		{"SHARE", share_usage},
+		{"SESSION", session_usage},
+		{"SERVER", server_usage},
+		{"DOMAIN", domain_usage},
+		{"PRINTQ", printq_usage},
+		{"USER", user_usage},
+		{"GROUP", group_usage},
+		{"VALIDATE", validate_usage},
+		{"GROUPMEMBER", groupmember_usage},
+		{"ADMIN", admin_usage},
+		{"SERVICE", service_usage},
+		{"PASSWORD", password_usage},
+		{NULL, NULL}};
+
+	return net_run_function(argc, argv, func, rap_help_usage);
+}
+
+/* Entry-point for all the RAP functions. */
+
+int net_rap(int argc, const char **argv)
+{
+	struct functable func[] = {
+		{"FILE", rap_file},
+		{"SHARE", rap_share},
+		{"SESSION", rap_session},
+		{"SERVER", rap_server},
+		{"DOMAIN", rap_domain},
+		{"PRINTQ", rap_printq},
+		{"USER", rap_user},
+		{"GROUP", rap_group},
+		{"VALIDATE", rap_validate},
+		{"GROUPMEMBER", rap_groupmember},
+		{"ADMIN", rap_admin},
+		{"SERVICE", rap_service},	
+		{"PASSWORD", rap_password},
+		{"HELP", rap_help},
+		{NULL, NULL}
+	};
+	
+	return net_run_function(argc, argv, func, net_rap_usage);
+}
+