dishhelp.c

来自「ftam等标准协议服务器和客户端的源代码。」· C语言 代码 · 共 194 行

/* dishhelp.c - */

#ifndef	lint
static char *rcsid = "$Header: /xtel/isode/isode/quipu/dish/RCS/dishhelp.c,v 9.0 1992/06/16 12:35:39 isode Rel $";
#endif

/* 
 * $Header: /xtel/isode/isode/quipu/dish/RCS/dishhelp.c,v 9.0 1992/06/16 12:35:39 isode Rel $
 *
 *
 * $Log: dishhelp.c,v $
 * Revision 9.0  1992/06/16  12:35:39  isode
 * Release 8.0
 *
 */

/*
 *				  NOTICE
 *
 *    Acquisition, use, and distribution of this module and related
 *    materials are subject to the restrictions of a license agreement.
 *    Consult the Preface in the User's Manual for the full terms of
 *    this agreement.
 *
 */


#include "quipu/util.h"
#include "quipu/name.h"

#define	OPT	(!frompipe || rps -> ps_byteno == 0 ? opt : rps)
#define	RPS	(!frompipe || opt -> ps_byteno == 0 ? rps : opt)
extern	char	frompipe;
extern	PS	opt, rps;
#define MAXARG 50

struct {
	char           *command;
	char           *args;
	char            serv;
	char	        other;
	char 	       *use;
	
} help_info[MAXARG];
int num_help = 0;

add_dish_help (command,args,serv,other,use)
char           *command;
char           *args;
char            serv;
char	        other;
char 	       *use;
{
	help_info[num_help].command = command;
	help_info[num_help].args = args;
	help_info[num_help].serv = serv;
	help_info[num_help].other = other;
	help_info[num_help].use = use;
	num_help++;
}

dish_help_init () {
	add_dish_help (
	"dish",		"[-pipe] [-noconnect] [-user <name>]\n[-password [<password>]] [-call <dsa name>] [-fast]\n[-simple] [-protected] [-strong] [-noauthentication]", FALSE, FALSE,
			"Directory Shell," );
	add_dish_help (
	"showentry", 	"[-[no]cache] [-[no]name] [-[no]move]", TRUE,TRUE,
			"show an entry, read it if not cached," );
	add_dish_help (
	"list", 	"[-nocache] [-noshow] [-[no]move]", TRUE,FALSE,
			"list children of the current node" );
	add_dish_help (
	"search", 	"[-baseobject] [-singlelevel] [-subtree]\n[-filter <filter>]\n[-[no]relative] [-[no]searchaliases] [-[no]partial] [-hitone]\n[-fred [-expand] [-full] [-summary] [-nofredseq] [-subdisplay]]", TRUE, TRUE,
			"search the tree for an object," );
	add_dish_help (
	"moveto", 	"[-[no]pwd] [-[no]check] [-sequence <name>] [-nosequence] <position>", FALSE, FALSE,
			"move to position in the DIT" );
	add_dish_help (
	"modify", 	"[-draft <draft> [-noedit]] [-newdraft]\n[-add <attr type>=<attr value>] [-remove <attr type>=<attr value>] ", TRUE, FALSE,
			"modify an existing node," );
	add_dish_help (
	"showname", 	"[-[no]compact] [-[no]ufn] [-[no]cache]", TRUE,TRUE,
			"show the name of an entry," );
	add_dish_help (
	"compare", 	"-attribute <attributeType '=' attributeValue>\n[-[no]print]", TRUE,FALSE,
			"compare attribute with the supplied value," );
	add_dish_help (
	"add", 		"[-draft <draft> [-noedit]] [-template <draft>] [-newdraft]\n [-objectclass <objectclass>]", TRUE,FALSE,
			"add a new node," );
	add_dish_help (
	"delete", 	"", TRUE,FALSE,
			"delete an object," );
	add_dish_help (
	"modifyrdn", 	"-name <attributeType '=' attributeValue> [-[no]delete]", TRUE, FALSE,
			"modify the name of a node," );
	add_dish_help (
	"squid",	"[-sequence <name>] [-alias <position>] [-version]\n[-user] [-syntax] [-fred]",FALSE, FALSE,
			"status of dish," );
	add_dish_help (
	"bind",		"[-noconnect] [[-user] <name>]\n[-password [<password>]] [-[no]refer]\n[-call <dsa name>]\n[-simple] [-protected] [-strong] [-noauthentication]", FALSE, FALSE,
			"connect to the directory," );
	add_dish_help (
	"unbind", 	"[-noquit]", FALSE, FALSE,
			"disconnect from the directory," );
	add_dish_help (
	"fred",		"[-display <name>]\n[-dm2dn [-list] [-phone] [-photo] <domain-or-mailbox>]\n[-expand [-full] <DN>]\n[-ufn [-list,][-mailbox,][-phone,][-photo,]<name...>]\n[-ufnrc <list...>]", FALSE, FALSE,
 			"back-end to fred," );
	add_dish_help (
	"dsacontrol", 	"[-[un]lock <entry>] [-dump <directory>]\n[-tailor <string>] [-abort] [-restart] [-info]\n[-refresh <entry>] [-resync <entry>] [-slave [<entry>]]", FALSE, FALSE,
			"control the operation of the DSA (managers only)," );
}

Usage (rtn)
char           *rtn;
{
	extern DN       dn,
	                savename;
	int             i;

	dn_free (dn);
	dn = savename;
	savename = NULLDN;

	if (print_arg_error (OPT) == OK)
		return;

	for (i = 0; help_info[i].command != 0; i++)
		if (strcmp (help_info[i].command, rtn) == 0) {
			if (help_info[i].serv) {
				ps_printf (OPT, "Usage %s [-help] [<object>] %s \n", rtn, help_info[i].args);
				print_other(OPT, help_info[i].other);
				ps_printf (OPT, "\n[<service controls>]\n");
			} else
				ps_printf (OPT, "Usage %s [-help] %s\n", rtn, help_info[i].args);
			return;
		}
	ps_print (OPT, "Usage...\n");
}

help_arg (rtn)
char           *rtn;
{
	int             i;

	for (i = 0; help_info[i].command != 0; i++)
		if (strcmp (help_info[i].command, rtn) == 0) {
			if (help_info[i].serv) {
				ps_printf (RPS, "%-10s - %s\n[<object>] %s ", rtn, help_info[i].use,help_info[i].args);
				print_other(RPS,help_info[i].other);
				ps_print (RPS,"\n");
				print_service();
			} else
				ps_printf (RPS, "%-10s - %s\n%s\n", rtn, help_info[i].use,help_info[i].args);
			return;
		}
	ps_print (OPT,"Sorry - No help available\n");
}

print_other (aps,x) 
PS aps;
char x;
{
	if (x == FALSE)
		return;
		
	ps_print (aps,"\n[-[no]types <attribute-type> *] [-[no]all]\n[-[no]value] [-[no]show] \n[-[no]key] [-edb]\n[-proc <syntax> <process>]");
}

print_service ()
{
	ps_print (RPS,"[-sequence <name>] [-nosequence]\n");
	ps_print (RPS,"[-[no]preferchain] [-[no]chaining]\n");
	ps_print (RPS,"[-[dont]usecopy] [-[dont]dereferencealias]\n");
	ps_print (RPS,"[-low] [-medium] [-high]\n");
	ps_print (RPS,"[-timelimit n] [-notimelimit]\n");
	ps_print (RPS,"[-sizelimit n] [-nosizelimit]\n");
	ps_print (RPS,"[-strong] [-[no]refer]\n");
	ps_print (RPS,"[-[no]localscope] [-help]\n");

}

call_help ()
{
	int             i;

	ps_print (RPS, "The following commands are recognised...\n\n");

	for (i = 0; help_info[i].command != 0; i++)
		ps_printf (RPS, "%-10s - %s\n", help_info[i].command, help_info[i].use);

	ps_print (RPS,"\nEnter <command> -help for help on that command\n");
	ps_print (RPS, "See the DISH manual for full details\n\n");
}