86 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			C
		
	
	
	
			
		
		
	
	
			86 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			C
		
	
	
	
| /* help.c - Show help for toybox commands
 | |
|  *
 | |
|  * Copyright 2007 Rob Landley <rob@landley.net>
 | |
|  *
 | |
|  * Often a shell builtin.
 | |
| 
 | |
| USE_HELP(NEWTOY(help, "ahu", TOYFLAG_BIN|TOYFLAG_MAYFORK))
 | |
| 
 | |
| config HELP
 | |
|   bool "help"
 | |
|   default y
 | |
|   depends on TOYBOX_HELP
 | |
|   help
 | |
|     usage: help [-ahu] [COMMAND]
 | |
| 
 | |
|     -a	All commands
 | |
|     -u	Usage only
 | |
|     -h	HTML output
 | |
| 
 | |
|     Show usage information for toybox commands.
 | |
|     Run "toybox" with no arguments for a list of available commands.
 | |
| */
 | |
| 
 | |
| #define FOR_help
 | |
| #include "toys.h"
 | |
| 
 | |
| static void do_help(struct toy_list *t)
 | |
| {
 | |
|   if (FLAG(h))
 | |
|     xprintf("<a name=\"%s\"><h1>%s</h1><blockquote><pre>\n", t->name, t->name);
 | |
| 
 | |
|   toys.which = t;
 | |
|   show_help(stdout, !FLAG(u)+(!!toys.argv[1]<<1));
 | |
| 
 | |
|   if (FLAG(h)) xprintf("</blockquote></pre>\n");
 | |
| }
 | |
| 
 | |
| // Simple help is just toys.which = toy_find("name"); show_help(stdout, 1);
 | |
| // but iterating through html output and all commands is a bit more
 | |
| 
 | |
| void help_main(void)
 | |
| {
 | |
|   int i;
 | |
| 
 | |
|   // If called with no arguments as a builtin from the shell, show all builtins
 | |
|   if (toys.rebound && !*toys.optargs && !toys.optflags) {
 | |
|     for (i = 0; i < toys.toycount; i++) {
 | |
|       if (!(toy_list[i].flags&(TOYFLAG_NOFORK|TOYFLAG_MAYFORK))) continue;
 | |
|       toys.which = toy_list+i;
 | |
|       show_help(stdout, FLAG(u));
 | |
|     }
 | |
|     return;
 | |
|   }
 | |
| 
 | |
|   if (!FLAG(a)) {
 | |
|     struct toy_list *t = toys.which;
 | |
| 
 | |
|     if (*toys.optargs && !(t = toy_find(*toys.optargs)))
 | |
|       error_exit("Unknown command '%s'", *toys.optargs);
 | |
|     do_help(t);
 | |
|     return;
 | |
|   }
 | |
| 
 | |
|   if (FLAG(h)) {
 | |
|     sprintf(toybuf, "Toybox %s command help", toybox_version);
 | |
|     xprintf("<html>\n<title>%s</title>\n<body>\n<h1>%s</h1><hr /><p>",
 | |
|             toybuf, toybuf);
 | |
|     for (i=0; i < toys.toycount; i++)
 | |
|       xprintf("<a href=\"#%s\">%s</a> \n", toy_list[i].name, toy_list[i].name);
 | |
|     xprintf("</p>\n");
 | |
|   }
 | |
| 
 | |
|   for (i = 0; i < toys.toycount; i++) {
 | |
|     if (FLAG(h)) xprintf("<hr>\n<pre>\n");
 | |
|     else if (!FLAG(u)) {
 | |
|       memset(toybuf, '-', 78);
 | |
|       memcpy(toybuf+3, toy_list[i].name, strlen(toy_list[i].name));
 | |
|       printf("\n%s\n\n", toybuf);
 | |
|     }
 | |
|     do_help(toy_list+i);
 | |
|     if (FLAG(h)) xprintf("</pre>\n");
 | |
|   }
 | |
| 
 | |
|   if (FLAG(h)) xprintf("</html>");
 | |
| }
 |