1 /* Functions for communicating with a remote tape drive.
3 Copyright 1988, 1992, 1994, 1996, 1997, 1999, 2000, 2001, 2004 Free
4 Software Foundation, Inc.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software Foundation,
18 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
20 /* The man page rmt(8) for /etc/rmt documents the remote mag tape protocol
21 which rdump and rrestore use. Unfortunately, the man page is *WRONG*.
22 The author of the routines I'm including originally wrote his code just
23 based on the man page, and it didn't work, so he went to the rdump source
24 to figure out why. The only thing he had to change was to check for the
25 'F' return code in addition to the 'E', and to separate the various
26 arguments with \n instead of a space. I personally don't think that this
27 is much of a problem, but I wanted to point it out. -- Arnold Robbins
29 Originally written by Jeff Lee, modified some by Arnold Robbins. Redone
30 as a library that can replace open, read, write, etc., by Fred Fish, with
31 some additional work by Arnold Robbins. Modified to make all rmt* calls
32 into macros for speed by Jay Fenlason. Use -DWITH_REXEC for rexec
33 code, courtesy of Dan Kegel. */
36 #include <safe-read.h>
37 #include <full-write.h>
39 /* Try hard to get EOPNOTSUPP defined. 486/ISC has it in net/errno.h,
40 3B2/SVR3 has it in sys/inet.h. Otherwise, like on MSDOS, use EINVAL. */
44 # include <net/errno.h>
47 # include <sys/inet.h>
50 # define EOPNOTSUPP EINVAL
61 #include <localedir.h>
63 /* Exit status if exec errors. */
64 #define EXIT_ON_EXEC_ERROR 128
66 /* FIXME: Size of buffers for reading and writing commands to rmt. */
67 #define COMMAND_BUFFER_SIZE 64
70 # define RETSIGTYPE void
73 /* FIXME: Maximum number of simultaneous remote tape connections. */
76 #define PREAD 0 /* read file descriptor from pipe() */
77 #define PWRITE 1 /* write file descriptor from pipe() */
79 /* Return the parent's read side of remote tape connection Fd. */
80 #define READ_SIDE(Fd) (from_remote[Fd][PREAD])
82 /* Return the parent's write side of remote tape connection Fd. */
83 #define WRITE_SIDE(Fd) (to_remote[Fd][PWRITE])
85 /* The pipes for receiving data from remote tape drives. */
86 static int from_remote[MAXUNIT][2] = {{-1, -1}, {-1, -1}, {-1, -1}, {-1, -1}};
88 /* The pipes for sending data to remote tape drives. */
89 static int to_remote[MAXUNIT][2] = {{-1, -1}, {-1, -1}, {-1, -1}, {-1, -1}};
91 char *rmt_command = DEFAULT_RMT_COMMAND;
93 /* Temporary variable used by macros in rmt.h. */
96 /* If true, always consider file names to be local, even if they contain
98 bool force_local_option;
102 /* Close remote tape connection HANDLE, and reset errno to ERRNO_VALUE. */
104 _rmt_shutdown (int handle, int errno_value)
106 close (READ_SIDE (handle));
107 close (WRITE_SIDE (handle));
108 READ_SIDE (handle) = -1;
109 WRITE_SIDE (handle) = -1;
113 /* Attempt to perform the remote tape command specified in BUFFER on
114 remote tape connection HANDLE. Return 0 if successful, -1 on
117 do_command (int handle, const char *buffer)
119 /* Save the current pipe handler and try to make the request. */
121 size_t length = strlen (buffer);
122 RETSIGTYPE (*pipe_handler) () = signal (SIGPIPE, SIG_IGN);
123 ssize_t written = full_write (WRITE_SIDE (handle), buffer, length);
124 signal (SIGPIPE, pipe_handler);
126 if (written == length)
129 /* Something went wrong. Close down and go home. */
131 _rmt_shutdown (handle, EIO);
136 get_status_string (int handle, char *command_buffer)
141 /* Read the reply command line. */
143 for (counter = 0, cursor = command_buffer;
144 counter < COMMAND_BUFFER_SIZE;
147 if (safe_read (READ_SIDE (handle), cursor, 1) != 1)
149 _rmt_shutdown (handle, EIO);
159 if (counter == COMMAND_BUFFER_SIZE)
161 _rmt_shutdown (handle, EIO);
165 /* Check the return status. */
167 for (cursor = command_buffer; *cursor; cursor++)
171 if (*cursor == 'E' || *cursor == 'F')
173 /* Skip the error message line. */
175 /* FIXME: there is better to do than merely ignoring error messages
176 coming from the remote end. Translate them, too... */
181 while (safe_read (READ_SIDE (handle), &character, 1) == 1)
182 if (character == '\n')
186 errno = atoi (cursor + 1);
189 _rmt_shutdown (handle, errno);
194 /* Check for mis-synced pipes. */
198 _rmt_shutdown (handle, EIO);
202 /* Got an `A' (success) response. */
207 /* Read and return the status from remote tape connection HANDLE. If
208 an error occurred, return -1 and set errno. */
210 get_status (int handle)
212 char command_buffer[COMMAND_BUFFER_SIZE];
213 const char *status = get_status_string (handle, command_buffer);
216 long int result = atol (status);
225 get_status_off (int handle)
227 char command_buffer[COMMAND_BUFFER_SIZE];
228 const char *status = get_status_string (handle, command_buffer);
234 /* Parse status, taking care to check for overflow.
235 We can't use standard functions,
236 since off_t might be longer than long. */
241 for (; *status == ' ' || *status == '\t'; status++)
244 negative = *status == '-';
245 status += negative || *status == '+';
249 int digit = *status++ - '0';
250 if (9 < (unsigned) digit)
254 off_t c10 = 10 * count;
255 off_t nc = negative ? c10 - digit : c10 + digit;
256 if (c10 / 10 != count || (negative ? c10 < nc : nc < c10))
268 /* Execute /etc/rmt as user USER on remote system HOST using rexec.
269 Return a file descriptor of a bidirectional socket for stdin and
270 stdout. If USER is zero, use the current username.
272 By default, this code is not used, since it requires that the user
273 have a .netrc file in his/her home directory, or that the
274 application designer be willing to have rexec prompt for login and
275 password info. This may be unacceptable, and .rhosts files for use
276 with rsh are much more common on BSD systems. */
278 _rmt_rexec (char *host, char *user)
280 int saved_stdin = dup (STDIN_FILENO);
281 int saved_stdout = dup (STDOUT_FILENO);
282 struct servent *rexecserv;
285 /* When using cpio -o < filename, stdin is no longer the tty. But the
286 rexec subroutine reads the login and the passwd on stdin, to allow
287 remote execution of the command. So, reopen stdin and stdout on
288 /dev/tty before the rexec and give them back their original value
291 if (! freopen ("/dev/tty", "r", stdin))
292 freopen ("/dev/null", "r", stdin);
293 if (! freopen ("/dev/tty", "w", stdout))
294 freopen ("/dev/null", "w", stdout);
296 if (rexecserv = getservbyname ("exec", "tcp"), !rexecserv)
297 error (EXIT_ON_EXEC_ERROR, 0, _("exec/tcp: Service not available"));
299 result = rexec (&host, rexecserv->s_port, user, 0, rmt_command, 0);
300 if (fclose (stdin) == EOF)
301 error (0, errno, _("stdin"));
302 fdopen (saved_stdin, "r");
303 if (fclose (stdout) == EOF)
304 error (0, errno, _("stdout"));
305 fdopen (saved_stdout, "w");
310 #endif /* WITH_REXEC */
312 /* Place into BUF a string representing OFLAG, which must be suitable
313 as argument 2 of `open'. BUF must be large enough to hold the
314 result. This function should generate a string that decode_oflag
317 encode_oflag (char *buf, int oflag)
319 sprintf (buf, "%d ", oflag);
321 switch (oflag & O_ACCMODE)
323 case O_RDONLY: strcat (buf, "O_RDONLY"); break;
324 case O_RDWR: strcat (buf, "O_RDWR"); break;
325 case O_WRONLY: strcat (buf, "O_WRONLY"); break;
330 if (oflag & O_APPEND) strcat (buf, "|O_APPEND");
332 if (oflag & O_CREAT) strcat (buf, "|O_CREAT");
334 if (oflag & O_DSYNC) strcat (buf, "|O_DSYNC");
336 if (oflag & O_EXCL) strcat (buf, "|O_EXCL");
338 if (oflag & O_LARGEFILE) strcat (buf, "|O_LARGEFILE");
341 if (oflag & O_NOCTTY) strcat (buf, "|O_NOCTTY");
344 if (oflag & O_NONBLOCK) strcat (buf, "|O_NONBLOCK");
347 if (oflag & O_RSYNC) strcat (buf, "|O_RSYNC");
350 if (oflag & O_SYNC) strcat (buf, "|O_SYNC");
352 if (oflag & O_TRUNC) strcat (buf, "|O_TRUNC");
355 /* Open a file (a magnetic tape device?) on the system specified in
356 FILE_NAME, as the given user. FILE_NAME has the form `[USER@]HOST:FILE'.
357 OPEN_MODE is O_RDONLY, O_WRONLY, etc. If successful, return the
358 remote pipe number plus BIAS. REMOTE_SHELL may be overridden. On
361 rmt_open__ (const char *file_name, int open_mode, int bias,
362 const char *remote_shell)
364 int remote_pipe_number; /* pseudo, biased file descriptor */
365 char *file_name_copy; /* copy of file_name string */
366 char *remote_host; /* remote host name */
367 char *remote_file; /* remote file name (often a device) */
368 char *remote_user; /* remote user name */
370 /* Find an unused pair of file descriptors. */
372 for (remote_pipe_number = 0;
373 remote_pipe_number < MAXUNIT;
374 remote_pipe_number++)
375 if (READ_SIDE (remote_pipe_number) == -1
376 && WRITE_SIDE (remote_pipe_number) == -1)
379 if (remote_pipe_number == MAXUNIT)
385 /* Pull apart the system and device, and optional user. */
390 file_name_copy = xstrdup (file_name);
391 remote_host = file_name_copy;
395 for (cursor = file_name_copy; *cursor; cursor++)
402 /* Do not allow newlines in the file_name, since the protocol
403 uses newline delimiters. */
404 free (file_name_copy);
411 remote_user = remote_host;
413 remote_host = cursor + 1;
421 remote_file = cursor + 1;
427 /* FIXME: Should somewhat validate the decoding, here. */
429 if (remote_user && *remote_user == '\0')
434 /* Execute the remote command using rexec. */
436 READ_SIDE (remote_pipe_number) = _rmt_rexec (remote_host, remote_user);
437 if (READ_SIDE (remote_pipe_number) < 0)
440 free (file_name_copy);
445 WRITE_SIDE (remote_pipe_number) = READ_SIDE (remote_pipe_number);
447 #else /* not WITH_REXEC */
449 const char *remote_shell_basename;
452 /* Identify the remote command to be executed. */
457 remote_shell = REMOTE_SHELL;
459 free (file_name_copy);
464 remote_shell_basename = base_name (remote_shell);
466 /* Set up the pipes for the `rsh' command, and fork. */
468 if (pipe (to_remote[remote_pipe_number]) == -1
469 || pipe (from_remote[remote_pipe_number]) == -1)
472 free (file_name_copy);
481 free (file_name_copy);
490 close (STDIN_FILENO);
491 dup (to_remote[remote_pipe_number][PREAD]);
492 close (to_remote[remote_pipe_number][PREAD]);
493 close (to_remote[remote_pipe_number][PWRITE]);
495 close (STDOUT_FILENO);
496 dup (from_remote[remote_pipe_number][PWRITE]);
497 close (from_remote[remote_pipe_number][PREAD]);
498 close (from_remote[remote_pipe_number][PWRITE]);
500 sys_reset_uid_gid ();
503 execl (remote_shell, remote_shell_basename, remote_host,
504 "-l", remote_user, rmt_command, (char *) 0);
506 execl (remote_shell, remote_shell_basename, remote_host,
507 rmt_command, (char *) 0);
509 /* Bad problems if we get here. */
511 /* In a previous version, _exit was used here instead of exit. */
512 error (EXIT_ON_EXEC_ERROR, errno, _("Cannot execute remote shell"));
517 close (from_remote[remote_pipe_number][PWRITE]);
518 close (to_remote[remote_pipe_number][PREAD]);
520 #endif /* not WITH_REXEC */
522 /* Attempt to open the tape device. */
525 size_t remote_file_len = strlen (remote_file);
526 char *command_buffer = xmalloc (remote_file_len + 1000);
527 sprintf (command_buffer, "O%s\n", remote_file);
528 encode_oflag (command_buffer + remote_file_len + 2, open_mode);
529 strcat (command_buffer, "\n");
530 if (do_command (remote_pipe_number, command_buffer) == -1
531 || get_status (remote_pipe_number) == -1)
534 free (command_buffer);
535 free (file_name_copy);
536 _rmt_shutdown (remote_pipe_number, e);
539 free (command_buffer);
542 free (file_name_copy);
543 return remote_pipe_number + bias;
546 /* Close remote tape connection HANDLE and shut down. Return 0 if
547 successful, -1 on error. */
549 rmt_close__ (int handle)
553 if (do_command (handle, "C\n") == -1)
556 status = get_status (handle);
557 _rmt_shutdown (handle, errno);
561 /* Read up to LENGTH bytes into BUFFER from remote tape connection HANDLE.
562 Return the number of bytes read on success, SAFE_READ_ERROR on error. */
564 rmt_read__ (int handle, char *buffer, size_t length)
566 char command_buffer[COMMAND_BUFFER_SIZE];
571 sprintf (command_buffer, "R%lu\n", (unsigned long) length);
572 if (do_command (handle, command_buffer) == -1
573 || (status = get_status (handle)) == SAFE_READ_ERROR)
574 return SAFE_READ_ERROR;
576 for (counter = 0; counter < status; counter += rlen, buffer += rlen)
578 rlen = safe_read (READ_SIDE (handle), buffer, status - counter);
579 if (rlen == SAFE_READ_ERROR || rlen == 0)
581 _rmt_shutdown (handle, EIO);
582 return SAFE_READ_ERROR;
589 /* Write LENGTH bytes from BUFFER to remote tape connection HANDLE.
590 Return the number of bytes written. */
592 rmt_write__ (int handle, char *buffer, size_t length)
594 char command_buffer[COMMAND_BUFFER_SIZE];
595 RETSIGTYPE (*pipe_handler) ();
598 sprintf (command_buffer, "W%lu\n", (unsigned long) length);
599 if (do_command (handle, command_buffer) == -1)
602 pipe_handler = signal (SIGPIPE, SIG_IGN);
603 written = full_write (WRITE_SIDE (handle), buffer, length);
604 signal (SIGPIPE, pipe_handler);
605 if (written == length)
607 long int r = get_status (handle);
617 _rmt_shutdown (handle, EIO);
621 /* Perform an imitation lseek operation on remote tape connection
622 HANDLE. Return the new file offset if successful, -1 if on error. */
624 rmt_lseek__ (int handle, off_t offset, int whence)
626 char command_buffer[COMMAND_BUFFER_SIZE];
627 char operand_buffer[UINTMAX_STRSIZE_BOUND];
628 uintmax_t u = offset < 0 ? - (uintmax_t) offset : (uintmax_t) offset;
629 char *p = operand_buffer + sizeof operand_buffer;
633 *--p = '0' + (int) (u % 10);
634 while ((u /= 10) != 0);
640 case SEEK_SET: whence = 0; break;
641 case SEEK_CUR: whence = 1; break;
642 case SEEK_END: whence = 2; break;
646 sprintf (command_buffer, "L%s\n%d\n", p, whence);
648 if (do_command (handle, command_buffer) == -1)
651 return get_status_off (handle);
654 /* Perform a raw tape operation on remote tape connection HANDLE.
655 Return the results of the ioctl, or -1 on error. */
657 rmt_ioctl__ (int handle, int operation, char *argument)
668 char command_buffer[COMMAND_BUFFER_SIZE];
669 char operand_buffer[UINTMAX_STRSIZE_BOUND];
670 uintmax_t u = (((struct mtop *) argument)->mt_count < 0
671 ? - (uintmax_t) ((struct mtop *) argument)->mt_count
672 : (uintmax_t) ((struct mtop *) argument)->mt_count);
673 char *p = operand_buffer + sizeof operand_buffer;
677 *--p = '0' + (int) (u % 10);
678 while ((u /= 10) != 0);
679 if (((struct mtop *) argument)->mt_count < 0)
682 /* MTIOCTOP is the easy one. Nothing is transferred in binary. */
684 sprintf (command_buffer, "I%d\n%s\n",
685 ((struct mtop *) argument)->mt_op, p);
686 if (do_command (handle, command_buffer) == -1)
689 return get_status (handle);
691 #endif /* MTIOCTOP */
699 /* Grab the status and read it directly into the structure. This
700 assumes that the status buffer is not padded and that 2 shorts
701 fit in a long without any word alignment problems; i.e., the
702 whole struct is contiguous. NOTE - this is probably NOT a good
705 if (do_command (handle, "S") == -1
706 || (status = get_status (handle), status == -1))
709 for (; status > 0; status -= counter, argument += counter)
711 counter = safe_read (READ_SIDE (handle), argument, status);
712 if (counter == SAFE_READ_ERROR || counter == 0)
714 _rmt_shutdown (handle, EIO);
719 /* Check for byte position. mt_type (or mt_model) is a small integer
720 field (normally) so we will check its magnitude. If it is larger
721 than 256, we will assume that the bytes are swapped and go through
722 and reverse all the bytes. */
724 if (((struct mtget *) argument)->MTIO_CHECK_FIELD < 256)
727 for (counter = 0; counter < status; counter += 2)
729 char copy = argument[counter];
731 argument[counter] = argument[counter + 1];
732 argument[counter + 1] = copy;
737 #endif /* MTIOCGET */