2N/A/* help.c - command to show a help text. */
2N/A/*
2N/A * GRUB -- GRand Unified Bootloader
2N/A * Copyright (C) 2005,2007,2008,2009 Free Software Foundation, Inc.
2N/A *
2N/A * GRUB is free software: you can redistribute it and/or modify
2N/A * it under the terms of the GNU General Public License as published by
2N/A * the Free Software Foundation, either version 3 of the License, or
2N/A * (at your option) any later version.
2N/A *
2N/A * GRUB is distributed in the hope that it will be useful,
2N/A * but WITHOUT ANY WARRANTY; without even the implied warranty of
2N/A * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
2N/A * GNU General Public License for more details.
2N/A *
2N/A * You should have received a copy of the GNU General Public License
2N/A * along with GRUB. If not, see <http://www.gnu.org/licenses/>.
2N/A */
2N/A
2N/A#include <grub/dl.h>
2N/A#include <grub/misc.h>
2N/A#include <grub/term.h>
2N/A#include <grub/extcmd.h>
2N/A#include <grub/i18n.h>
2N/A#include <grub/mm.h>
2N/A#include <grub/normal.h>
2N/A#include <grub/charset.h>
2N/A
2N/AGRUB_MOD_LICENSE ("GPLv3+");
2N/A
2N/Astatic grub_err_t
2N/Agrub_cmd_help (grub_extcmd_context_t ctxt __attribute__ ((unused)), int argc,
2N/A char **args)
2N/A{
2N/A int cnt = 0;
2N/A char *currarg;
2N/A
2N/A if (argc == 0)
2N/A {
2N/A grub_command_t cmd;
2N/A FOR_COMMANDS(cmd)
2N/A {
2N/A if ((cmd->prio & GRUB_PRIO_LIST_FLAG_ACTIVE))
2N/A {
2N/A struct grub_term_output *term;
2N/A const char *summary_translated = _(cmd->summary);
2N/A char *command_help;
2N/A grub_uint32_t *unicode_command_help;
2N/A grub_uint32_t *unicode_last_position;
2N/A
2N/A command_help = grub_xasprintf ("%s %s", cmd->name, summary_translated);
2N/A if (!command_help)
2N/A break;
2N/A
2N/A grub_utf8_to_ucs4_alloc (command_help, &unicode_command_help,
2N/A &unicode_last_position);
2N/A
2N/A FOR_ACTIVE_TERM_OUTPUTS(term)
2N/A {
2N/A unsigned stringwidth;
2N/A grub_uint32_t *unicode_last_screen_position;
2N/A
2N/A unicode_last_screen_position = unicode_command_help;
2N/A
2N/A stringwidth = 0;
2N/A
2N/A while (unicode_last_screen_position < unicode_last_position &&
2N/A stringwidth < ((grub_term_width (term) / 2) - 2))
2N/A {
2N/A struct grub_unicode_glyph glyph;
2N/A unicode_last_screen_position
2N/A += grub_unicode_aglomerate_comb (unicode_last_screen_position,
2N/A unicode_last_position
2N/A - unicode_last_screen_position,
2N/A &glyph);
2N/A
2N/A stringwidth
2N/A += grub_term_getcharwidth (term, &glyph);
2N/A }
2N/A
2N/A grub_print_ucs4 (unicode_command_help,
2N/A unicode_last_screen_position, 0, 0, term);
2N/A if (!(cnt % 2))
2N/A grub_print_spaces (term, grub_term_width (term) / 2
2N/A - stringwidth);
2N/A }
2N/A
2N/A if (cnt % 2)
2N/A grub_printf ("\n");
2N/A cnt++;
2N/A
2N/A grub_free (command_help);
2N/A grub_free (unicode_command_help);
2N/A }
2N/A }
2N/A if (!(cnt % 2))
2N/A grub_printf ("\n");
2N/A }
2N/A else
2N/A {
2N/A int i;
2N/A grub_command_t cmd;
2N/A
2N/A for (i = 0; i < argc; i++)
2N/A {
2N/A currarg = args[i];
2N/A FOR_COMMANDS(cmd)
2N/A {
2N/A if (cmd->prio & GRUB_PRIO_LIST_FLAG_ACTIVE)
2N/A {
2N/A if (! grub_strncmp (cmd->name, currarg, grub_strlen (currarg)))
2N/A {
2N/A if (cnt++ > 0)
2N/A grub_printf ("\n\n");
2N/A
2N/A if ((cmd->flags & GRUB_COMMAND_FLAG_EXTCMD) &&
2N/A ! (cmd->flags & GRUB_COMMAND_FLAG_DYNCMD))
2N/A grub_arg_show_help ((grub_extcmd_t) cmd->data);
2N/A else
2N/A grub_printf ("%s %s %s\n%s\n", _("Usage:"), cmd->name, _(cmd->summary),
2N/A _(cmd->description));
2N/A }
2N/A }
2N/A }
2N/A }
2N/A }
2N/A
2N/A return 0;
2N/A}
2N/A
2N/Astatic grub_extcmd_t cmd;
2N/A
2N/AGRUB_MOD_INIT(help)
2N/A{
2N/A cmd = grub_register_extcmd ("help", grub_cmd_help, 0,
2N/A N_("[PATTERN ...]"),
2N/A N_("Show a help message."), 0);
2N/A}
2N/A
2N/AGRUB_MOD_FINI(help)
2N/A{
2N/A grub_unregister_extcmd (cmd);
2N/A}