fish: Add 'display' command for displaying graphical files.
authorRichard W.M. Jones <rjones@redhat.com>
Tue, 28 Jun 2011 17:58:54 +0000 (18:58 +0100)
committerRichard W.M. Jones <rjones@redhat.com>
Tue, 28 Jun 2011 17:58:54 +0000 (18:58 +0100)
fish/Makefile.am
fish/display.c [new file with mode: 0644]
fish/fish.h
fish/guestfish.pod
generator/generator_actions.ml
po/POTFILES.in

index 69540dd..9e05170 100644 (file)
@@ -75,6 +75,7 @@ guestfish_SOURCES = \
        cmds_gperf.h \
        copy.c \
        destpaths.c \
+       display.c \
        echo.c \
        edit.c \
        fish.c \
diff --git a/fish/display.c b/fish/display.c
new file mode 100644 (file)
index 0000000..4a46ea8
--- /dev/null
@@ -0,0 +1,95 @@
+/* guestfish - the filesystem interactive shell
+ * Copyright (C) 2011 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 <fcntl.h>
+#include <inttypes.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "fish.h"
+
+int
+run_display (const char *cmd, size_t argc, char *argv[])
+{
+  TMP_TEMPLATE_ON_STACK (filename);
+  char *remote;
+  const char *display;
+  char buf[256];
+  int r, fd;
+
+  if (argc != 1) {
+    fprintf (stderr, _("display filename\n"));
+    return -1;
+  }
+
+  /* Choose a display command. */
+  display = getenv ("GUESTFISH_DISPLAY_IMAGE");
+  if (display == NULL)
+    display = "display";
+
+  remote = argv[0];
+
+  /* Allow win:... prefix on remote. */
+  remote = win_prefix (remote);
+  if (remote == NULL)
+    return -1;
+
+  /* Download the file and write it to a temporary. */
+  fd = mkstemp (filename);
+  if (fd == -1) {
+    perror ("mkstemp");
+    free (remote);
+    return -1;
+  }
+
+  snprintf (buf, sizeof buf, "/dev/fd/%d", fd);
+
+  if (guestfs_download (g, remote, buf) == -1) {
+    close (fd);
+    unlink (filename);
+    free (remote);
+    return -1;
+  }
+
+  if (close (fd) == -1) {
+    perror (filename);
+    unlink (filename);
+    free (remote);
+    return -1;
+  }
+
+  /* View it. */
+  snprintf (buf, sizeof buf, "%s %s", display, filename);
+
+  r = system (buf);
+  unlink (filename);
+  if (r != 0) {
+    perror (buf);
+    free (remote);
+    return -1;
+  }
+
+  free (remote);
+  return 0;
+}
index a885b89..6f242da 100644 (file)
@@ -102,6 +102,9 @@ extern int parse_size (const char *str, off_t *size_rtn);
 extern int run_copy_in (const char *cmd, size_t argc, char *argv[]);
 extern int run_copy_out (const char *cmd, size_t argc, char *argv[]);
 
+/* in display.c */
+extern int run_display (const char *cmd, size_t argc, char *argv[]);
+
 /* in echo.c */
 extern int run_echo (const char *cmd, size_t argc, char *argv[]);
 
index 77bf0ca..a3d944d 100644 (file)
@@ -1023,6 +1023,11 @@ guestfish returns 0 if the commands completed without error, or
 The C<edit> command uses C<$EDITOR> as the editor.  If not
 set, it uses C<vi>.
 
+=item GUESTFISH_DISPLAY_IMAGE
+
+The C<display> command uses C<$GUESTFISH_DISPLAY_IMAGE> to
+display images.  If not set, it uses L<display(1)>.
+
 =item GUESTFISH_PID
 
 Used with the I<--remote> option to specify the remote guestfish
@@ -1169,6 +1174,7 @@ L<virt-tar(1)>,
 L<virt-tar-in(1)>,
 L<virt-tar-out(1)>,
 L<virt-win-reg(1)>,
+L<display(1)>,
 L<hexedit(1)>.
 
 =head1 AUTHORS
index d741dfb..b0b4af4 100644 (file)
@@ -6060,6 +6060,20 @@ them with the help of L</glob> like this:
 
  glob copy-out /home/* .");
 
+  ("display", (RErr,[], []), -1, [], [],
+   "display an image",
+   " display filename
+
+Use C<display> (a graphical display program) to display an image
+file.  It downloads the file, and runs C<display> on it.
+
+To use an alternative program, set the C<GUESTFISH_DISPLAY_IMAGE>
+environment variable.  For example to use the GNOME display program:
+
+ export GUESTFISH_DISPLAY_IMAGE=eog
+
+See also L<display(1)>.");
+
   ("echo", (RErr,[], []), -1, [], [],
    "display a line of text",
    " echo [params ...]
index c3f671a..069ccb1 100644 (file)
@@ -87,6 +87,7 @@ fish/completion.c
 fish/config.c
 fish/copy.c
 fish/destpaths.c
+fish/display.c
 fish/echo.c
 fish/edit.c
 fish/fish.c