Added outline of shell command, added generator support.

4 files changed, 232 insertions, 0 deletions

diff --git a/fish/Makefile.am b/fish/Makefile.am
new file mode 100644
index 00000000..b8f07ed8
--- /dev/null
+++ b/fish/Makefile.am
@@ -0,0 +1,25 @@
+# libguestfs
+# Copyright (C) 2009 Red Hat Inc.
+#
+# 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.
+
+bin_PROGRAMS = guestfish
+
+guestfish_SOURCES = \
+	cmds.c \
+	fish.c \
+	fish.h
+guestfish_CFLAGS = -I$(top_builddir)/src -Wall
+guestfish_LDADD = $(top_builddir)/src/libguestfs.la
diff --git a/fish/cmds.c b/fish/cmds.c
new file mode 100644
index 00000000..d0ab20c7
--- /dev/null
+++ b/fish/cmds.c
@@ -0,0 +1,53 @@
+/* libguestfs generated file
+ * WARNING: THIS FILE IS GENERATED BY 'src/generator.ml'.
+ * ANY CHANGES YOU MAKE TO THIS FILE WILL BE LOST.
+ *
+ * Copyright (C) 2009 Red Hat Inc.
+ *
+ * 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.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include "fish.h"
+
+void list_commands (void)
+{
+  printf ("%-20s %s\n", "Command", "Description");
+  printf ("%-20s %s\n", "mount", "Mount a guest disk at a position in the filesystem");
+  printf ("%-20s %s\n", "sync", "Sync disks, writes are flushed through to the disk image");
+  printf ("%-20s %s\n", "touch", "Update file timestamps or create a new file");
+  printf ("Use -h <cmd> to show detailed help for a command.\n");
+}
+
+void display_command (const char *cmd)
+{
+  if (strcasecmp (cmd, "mount") == 0)
+    pod2text ("mount - Mount a guest disk at a position in the filesystem", " mount <device> <mountpoint>\n\nMount a guest disk at a position in the filesystem.  Block devices\nare named C</dev/sda>, C</dev/sdb> and so on, as they were added to\nthe guest.  If those block devices contain partitions, they will have\nthe usual names (eg. C</dev/sda1>).  Also LVM C</dev/VG/LV>-style\nnames can be used.\n\nThe rules are the same as for L<mount(2)>:  A filesystem must\nfirst be mounted on C</> before others can be mounted.  Other\nfilesystems can only be mounted on directories which already\nexist.\n\nThe mounted filesystem is writable, if we have sufficient permissions\non the underlying device.\n\nThe filesystem options C<sync> and C<noatime> are set with this\ncall, in order to improve reliability.");
+  else
+  if (strcasecmp (cmd, "sync") == 0)
+    pod2text ("sync - Sync disks, writes are flushed through to the disk image", " sync\n\nThis syncs the disk, so that any writes are flushed through to the\nunderlying disk image.\n\nYou should always call this if you have modified a disk image, before\ncalling C<guestfs_close>.");
+  else
+  if (strcasecmp (cmd, "touch") == 0)
+    pod2text ("touch - Update file timestamps or create a new file", " touch <path>\n\nTouch acts like the L<touch(1)> command.  It can be used to\nupdate the timestamps on a file, or, if the file does not exist,\nto create a new zero-length file.");
+  else
+  {
+    fprintf (stderr, "%s: command not known, use -h to list all commands\n", cmd);
+    exit (1);
+  }
+}
+
diff --git a/fish/fish.c b/fish/fish.c
new file mode 100644
index 00000000..85543004
--- /dev/null
+++ b/fish/fish.c
@@ -0,0 +1,125 @@
+/* guestfish - the filesystem shell
+ * Copyright (C) 2009 Red Hat Inc. 
+ *
+ * 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 <config.h>
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include <getopt.h>
+
+#include <guestfs.h>
+
+#include "fish.h"
+
+static void
+usage (void)
+{
+  fprintf (stderr,
+	   "guestfish: guest filesystem shell\n"
+	   "guestfish lets you edit virtual machine filesystems\n"
+	   "Copyright (C) 2009 Red Hat Inc.\n"
+	   "Usage:\n"
+	   "  guestfish [--options] [cmd]\n"
+	   "or for interactive use:\n"
+	   "  guestfish\n"
+	   "or from a shell script:\n"
+	   "  guestfish <<EOF\n"
+	   "  cmd\n"
+	   "  ...\n"
+	   "  EOF\n"
+	   "Options:\n"
+	   "  -h|--cmd-help       List available commands\n"
+	   "  -h|--cmd-help cmd   Display detailed help on 'cmd'\n"
+	   "For more information, see the manual page guestfish(1).\n");
+}
+
+int
+main (int argc, char *argv[])
+{
+  static const char *options = "h::?";
+  static struct option long_options[] = {
+    { "cmd-help", 2, 0, 'h' },
+    { "help", 0, 0, '?' },
+    { 0, 0, 0, 0 }
+  };
+  int c;
+
+  for (;;) {
+    c = getopt_long (argc, argv, options, long_options, NULL);
+    if (c == -1) break;
+
+    switch (c) {
+    case 'h':
+      if (optarg)
+	display_command (optarg);
+      else if (argv[optind] && argv[optind][0] != '-')
+	display_command (argv[optind++]);
+      else
+	list_commands ();
+      exit (0);
+
+    case '?':
+      usage ();
+      exit (0);
+
+    default:
+      fprintf (stderr, "guestfish: unexpected command line option 0x%x\n", c);
+      exit (1);
+    }
+  }
+
+  if (optind < argc) {
+    usage ();
+    exit (1);
+  }
+
+
+
+
+
+
+
+
+
+
+
+
+  exit (0);
+}
+
+void
+pod2text (const char *heading, const char *str)
+{
+  FILE *fp;
+
+  fp = popen ("pod2text", "w");
+  if (fp == NULL) {
+    /* pod2text failed, maybe not found, so let's just print the
+     * source instead, since that's better than doing nothing.
+     */
+    printf ("%s\n\n%s\n", heading, str);
+    return;
+  }
+  fputs ("=head1 ", fp);
+  fputs (heading, fp);
+  fputs ("\n\n", fp);
+  fputs (str, fp);
+  pclose (fp);
+}
diff --git a/fish/fish.h b/fish/fish.h
new file mode 100644
index 00000000..3e811703
--- /dev/null
+++ b/fish/fish.h
@@ -0,0 +1,29 @@
+/* libguestfs - the guestfsd daemon
+ * Copyright (C) 2009 Red Hat Inc.
+ *
+ * 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.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ */
+
+#ifndef FISH_H
+#define FISH_H
+
+/* in fish.c */
+extern void pod2text (const char *heading, const char *body);
+
+/* in cmds.c (auto-generated) */
+extern void list_commands (void);
+extern void display_command (const char *cmd);
+
+#endif /* FISH_H */