Skip to contentSkip to conversation

read command

PATCH In review Robert Millan 2 participants 6 messages Feb 1, 2008 – Feb 2, 2008

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 read command

Implements a BASH-like read command.

Signature · 5 lines
Robert Millan

<GPLv2> I know my rights; I want my phone call!
<DRM> What use is a phone call… if you are unable to speak?
(as seen on /.)

* commands/read.c: New file.
* conf/common.rmk (pkglib_MODULES): Add `commands/read.c'. (read_mod_SOURCES): New variable. (read_mod_CFLAGS): Likewise. (read_mod_LDFLAGS): Likewise.

commands/read.c renamed from grub2/commands/read.c +77 -0
diff -x CVS -x '*~' -x '*.mk' -urp -N ../grub2/commands/read.c ./commands/read.c
@@ -0,0 +1,77 @@
+/* read.c - Command to read variables from user.  */
+/*
+ *  GRUB  --  GRand Unified Bootloader
+ *  Copyright (C) 2006,2007,2008  Free Software Foundation, Inc.
+ *
+ *  GRUB 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 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  GRUB 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 GRUB.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <grub/dl.h>
+#include <grub/misc.h>
+#include <grub/mm.h>
+#include <grub/normal.h>
+#include <grub/term.h>
+#include <grub/types.h>
+
+static void *
+grub_xrealloc (void *ptr, grub_size_t size)
+{
+  void *value = grub_realloc (ptr, size);
+  if (value == 0)
+    grub_fatal ("Virtual memory exhausted");
+  return value;
+}
+
+static char *
+grub_getline (void)
+{
+  int i;
+  char *line;
+
+  i = 0;
+  line = grub_malloc (1 + i + sizeof('\0'));
+
+  while ((line[i - 1] != '\n') && (line[i - 1] != '\r'))
+    {
+      line[i] = grub_getkey ();
+      if (grub_isprint (line[i]))
+	grub_putchar (line[i]);
+      i++;
+      line = grub_xrealloc (line, 1 + i + sizeof('\0'));
+    }
+  line[i] = '\0';
+
+  return line;
+}
+
+static grub_err_t
+grub_cmd_read (struct grub_arg_list *state UNUSED, int argc, char **args)
+{
+  char *line = grub_getline ();
+  if (argc > 0)
+    grub_env_set (args[0], line);
+  return 0;
+}
+
+
+GRUB_MOD_INIT(read)
+{
+  grub_register_command ("read", grub_cmd_read, GRUB_COMMAND_FLAG_CMDLINE,
+			 "read [ENVVAR]", "Set variable with user input", 0);
+}
+
+GRUB_MOD_FINI(read)
+{
+  grub_unregister_command ("read");
+}
conf/common.rmk renamed from grub2/conf/common.rmk +6 -3
diff -x CVS -x '*~' -x '*.mk' -urp -N ../grub2/conf/common.rmk ./conf/common.rmk
@@ -231,7 +231,8 @@ lvm_mod_LDFLAGS = $(COMMON_LDFLAGS)
 pkglib_MODULES += hello.mod boot.mod terminal.mod ls.mod	\
 	cmp.mod cat.mod help.mod font.mod search.mod		\
 	loopback.mod configfile.mod echo.mod			\
-	terminfo.mod test.mod blocklist.mod hexdump.mod
+	terminfo.mod test.mod blocklist.mod hexdump.mod		\
+	read.mod
 
 # For hello.mod.
 hello_mod_SOURCES = hello/hello.c
@@ -326,5 +327,7 @@ gzio_mod_SOURCES = io/gzio.c
 gzio_mod_CFLAGS = $(COMMON_CFLAGS)
 gzio_mod_LDFLAGS = $(COMMON_LDFLAGS)
 
-
-
+# For read.mod.
+read_mod_SOURCES = commands/read.c
+read_mod_CFLAGS = $(COMMON_CFLAGS)
+read_mod_LDFLAGS = $(COMMON_LDFLAGS)
#1 lore raw
Quoted 20 lines · Robert Millan
commands/read.c renamed from grub2/commands/read.c +20 -0
+static void *
+grub_xrealloc (void *ptr, grub_size_t size)
+{
+  void *value = grub_realloc (ptr, size);
+  if (value == 0)
+    grub_fatal ("Virtual memory exhausted");
+  return value;
+}
+
+static char *
+grub_getline (void)
+{
+  int i;
+  char *line;
+
+  i = 0;
+  line = grub_malloc (1 + i + sizeof('\0'));
+
+  while ((line[i - 1] != '\n') && (line[i - 1] != '\r'))
+    {

commands/read.c line 56

Quoted 10 lines
commands/read.c renamed from grub2/commands/read.c +10 -0
+      line[i] = grub_getkey ();
+      if (grub_isprint (line[i]))
+	grub_putchar (line[i]);
+      i++;
+      line = grub_xrealloc (line, 1 + i + sizeof('\0'));
+    }
+  line[i] = '\0';
+
+  return line;
+}

Does it make sense to move any of these two to kernel? Or to normal.mod ? Or maybe just to un-static-ize them and leave them here?

Signature · 5 lines
Robert Millan

<GPLv2> I know my rights; I want my phone call!
<DRM> What use is a phone call… if you are unable to speak?
(as seen on /.)
#2 lore raw
Quoted 26 lines · Robert Millan
Quoted 25 lines · Robert Millan
commands/read.c renamed from grub2/commands/read.c +25 -0
+static void *
+grub_xrealloc (void *ptr, grub_size_t size)
+{
+  void *value = grub_realloc (ptr, size);
+  if (value == 0)
+    grub_fatal ("Virtual memory exhausted");
+  return value;
+}
+
+static char *
+grub_getline (void)
+{
+  int i;
+  char *line;
+
+  i = 0;
+  line = grub_malloc (1 + i + sizeof('\0'));
+
+  while ((line[i - 1] != '\n') && (line[i - 1] != '\r'))
+    {
+      line[i] = grub_getkey ();
+      if (grub_isprint (line[i]))
+	grub_putchar (line[i]);
+      i++;
+      line = grub_xrealloc (line, 1 + i + sizeof('\0'));
Quoted 8 lines

commands/read.c line 56

Quoted 5 lines
commands/read.c renamed from grub2/commands/read.c +5 -0
+    }
+  line[i] = '\0';
+
+  return line;
+}

Does it make sense to move any of these two to kernel? Or to normal.mod ? Or maybe just to un-static-ize them and leave them here?

What would be other use cases?

BTW it is a bad idea to use xrealloc. xmalloc and xrealloc are sometimes used in the GNU Project, but they must not be used in GRUB. If a program runs in user space, when it panics, the control is back to the OS. But GRUB is a standalone program. When it panics, the user loses any kind of control. Thus grub_fatal must be used only if there is nothing else you can do.

In this case, grub_getline should simply return NULL. How the user deals with this situation is up to the user.

Okuji

#3 lore raw
Quoted 5 lines · Yoshinori K. Okuji
Quoted 3 lines

Does it make sense to move any of these two to kernel? Or to normal.mod ? Or maybe just to un-static-ize them and leave them here?

What would be other use cases?

No idea. I suggest we just leave grub_getline here and if later we find it's needed we can move it to normal or kernel.

Quoted 8 lines

BTW it is a bad idea to use xrealloc. xmalloc and xrealloc are sometimes used in the GNU Project, but they must not be used in GRUB. If a program runs in user space, when it panics, the control is back to the OS. But GRUB is a standalone program. When it panics, the user loses any kind of control. Thus grub_fatal must be used only if there is nothing else you can do.

In this case, grub_getline should simply return NULL. How the user deals with this situation is up to the user.

Ok, here's a new patch, with grub_getline returning NULL and the caller handling "out of mem" error.

Also fixed a memleak.

Signature · 5 lines
Robert Millan

<GPLv2> I know my rights; I want my phone call!
<DRM> What use is a phone call… if you are unable to speak?
(as seen on /.)

* commands/read.c: New file.
* conf/common.rmk (pkglib_MODULES): Add `commands/read.c'. (read_mod_SOURCES): New variable. (read_mod_CFLAGS): Likewise. (read_mod_LDFLAGS): Likewise.

commands/read.c renamed from grub2/commands/read.c +79 -0
diff -x CVS -x '*~' -x '*.mk' -urp -N ../grub2/commands/read.c ./commands/read.c
@@ -0,0 +1,79 @@
+/* read.c - Command to read variables from user.  */
+/*
+ *  GRUB  --  GRand Unified Bootloader
+ *  Copyright (C) 2006,2007,2008  Free Software Foundation, Inc.
+ *
+ *  GRUB 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 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  GRUB 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 GRUB.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <grub/dl.h>
+#include <grub/misc.h>
+#include <grub/mm.h>
+#include <grub/normal.h>
+#include <grub/term.h>
+#include <grub/types.h>
+
+static char *
+grub_getline (void)
+{
+  int i;
+  char *line;
+  char *tmp;
+
+  i = 0;
+  line = grub_malloc (1 + i + sizeof('\0'));
+
+  while ((line[i - 1] != '\n') && (line[i - 1] != '\r'))
+    {
+      line[i] = grub_getkey ();
+      if (grub_isprint (line[i]))
+	grub_putchar (line[i]);
+      i++;
+      tmp = grub_realloc (line, 1 + i + sizeof('\0'));
+      if (! tmp)
+	{
+	  grub_free (line);
+	  return NULL;
+	}
+      line = tmp;
+    }
+  line[i] = '\0';
+
+  return line;
+}
+
+static grub_err_t
+grub_cmd_read (struct grub_arg_list *state UNUSED, int argc, char **args)
+{
+  char *line = grub_getline ();
+  if (! line)
+    return grub_error (GRUB_ERR_OUT_OF_MEMORY, "Out of memory");
+  if (argc > 0)
+    grub_env_set (args[0], line);
+
+  grub_free (line);
+  return 0;
+}
+
+
+GRUB_MOD_INIT(read)
+{
+  grub_register_command ("read", grub_cmd_read, GRUB_COMMAND_FLAG_CMDLINE,
+			 "read [ENVVAR]", "Set variable with user input", 0);
+}
+
+GRUB_MOD_FINI(read)
+{
+  grub_unregister_command ("read");
+}
conf/common.rmk renamed from grub2/conf/common.rmk +6 -3
diff -x CVS -x '*~' -x '*.mk' -urp -N ../grub2/conf/common.rmk ./conf/common.rmk
@@ -231,7 +231,8 @@ lvm_mod_LDFLAGS = $(COMMON_LDFLAGS)
 pkglib_MODULES += hello.mod boot.mod terminal.mod ls.mod	\
 	cmp.mod cat.mod help.mod font.mod search.mod		\
 	loopback.mod configfile.mod echo.mod			\
-	terminfo.mod test.mod blocklist.mod hexdump.mod
+	terminfo.mod test.mod blocklist.mod hexdump.mod		\
+	read.mod
 
 # For hello.mod.
 hello_mod_SOURCES = hello/hello.c
@@ -326,5 +327,7 @@ gzio_mod_SOURCES = io/gzio.c
 gzio_mod_CFLAGS = $(COMMON_CFLAGS)
 gzio_mod_LDFLAGS = $(COMMON_LDFLAGS)
 
-
-
+# For read.mod.
+read_mod_SOURCES = commands/read.c
+read_mod_CFLAGS = $(COMMON_CFLAGS)
+read_mod_LDFLAGS = $(COMMON_LDFLAGS)
#4 lore raw
Quoted 8 lines · Robert Millan
Quoted 4 lines · Yoshinori K. Okuji
Quoted 2 lines

Does it make sense to move any of these two to kernel? Or to normal.mod ? Or maybe just to un-static-ize them and leave them here?

What would be other use cases?

No idea. I suggest we just leave grub_getline here and if later we find it's needed we can move it to normal or kernel.

OK.

Quoted 4 lines

Ok, here's a new patch, with grub_getline returning NULL and the caller handling "out of mem" error.

Also fixed a memleak.

You don't have to set grub_errno explicitly, because grub_realloc should do it.

And, you didn't check the return value from grub_malloc.

Okuji

#5 lore raw
Quoted 9 lines · Yoshinori K. Okuji
Quoted 4 lines

Ok, here's a new patch, with grub_getline returning NULL and the caller handling "out of mem" error.

Also fixed a memleak.

You don't have to set grub_errno explicitly, because grub_realloc should do it.

And, you didn't check the return value from grub_malloc.

Fixed and committed.

Signature · 5 lines
Robert Millan

<GPLv2> I know my rights; I want my phone call!
<DRM> What use is a phone call… if you are unable to speak?
(as seen on /.)