builtins/fg_bg.def

   1 This file is fg_bg.def, from which is created fg_bg.c.
   2 It implements the builtins "bg" and "fg" in Bash.
   3
   4 Copyright (C) 1987-2002 Free Software Foundation, Inc.
   5
   6 This file is part of GNU Bash, the Bourne Again SHell.
   7
   8 Bash is free software; you can redistribute it and/or modify it under
   9 the terms of the GNU General Public License as published by the Free
  10 Software Foundation; either version 2, or (at your option) any later
  11 version.
  12
  13 Bash is distributed in the hope that it will be useful, but WITHOUT ANY
  14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  15 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  16 for more details.
  17
  18 You should have received a copy of the GNU General Public License along
  19 with Bash; see the file COPYING.  If not, write to the Free Software
  20 Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
  21
  22 $PRODUCES fg_bg.c
  23
  24 $BUILTIN fg
  25 $FUNCTION fg_builtin
  26 $DEPENDS_ON JOB_CONTROL
  27 $SHORT_DOC fg [job_spec]
  28 Place JOB_SPEC in the foreground, and make it the current job.  If
  29 JOB_SPEC is not present, the shell's notion of the current job is
  30 used.
  31 $END
  32
  33 #include <config.h>
  34
  35 #include "../bashtypes.h"
  36 #include <signal.h>
  37
  38 #if defined (HAVE_UNISTD_H)
  39 #  include <unistd.h>
  40 #endif
  41
  42 #include "../shell.h"
  43 #include "../jobs.h"
  44 #include "common.h"
  45 #include "bashgetopt.h"
  46
  47 #if defined (JOB_CONTROL)
  48 extern char *this_command_name;
  49
  50 static int fg_bg __P((WORD_LIST *, int));
  51
  52 /* How to bring a job into the foreground. */
  53 int
  54 fg_builtin (list)
  55      WORD_LIST *list;
  56 {
  57   int fg_bit;
  58   register WORD_LIST *t;
  59
  60   if (job_control == 0)
  61     {
  62       sh_nojobs ((char *)NULL);
  63       return (EXECUTION_FAILURE);
  64     }
  65
  66   if (no_options (list))
  67     return (EX_USAGE);
  68   list = loptend;
  69
  70   /* If the last arg on the line is '&', then start this job in the
  71      background.  Else, fg the job. */
  72   for (t = list; t && t->next; t = t->next)
  73     ;
  74   fg_bit = (t && t->word->word[0] == '&' && t->word->word[1] == '\0') == 0;
  75
  76   return (fg_bg (list, fg_bit));
  77 }
  78 #endif /* JOB_CONTROL */
  79
  80 $BUILTIN bg
  81 $FUNCTION bg_builtin
  82 $DEPENDS_ON JOB_CONTROL
  83 $SHORT_DOC bg [job_spec]
  84 Place JOB_SPEC in the background, as if it had been started with
  85 `&'.  If JOB_SPEC is not present, the shell's notion of the current
  86 job is used.
  87 $END
  88
  89 #if defined (JOB_CONTROL)
  90 /* How to put a job into the background. */
  91 int
  92 bg_builtin (list)
  93      WORD_LIST *list;
  94 {
  95   if (job_control == 0)
  96     {
  97       sh_nojobs ((char *)NULL);
  98       return (EXECUTION_FAILURE);
  99     }
 100
 101   if (no_options (list))
 102     return (EX_USAGE);
 103   list = loptend;
 104
 105   return (fg_bg (list, 0));
 106 }
 107
 108 /* How to put a job into the foreground/background. */
 109 static int
 110 fg_bg (list, foreground)
 111      WORD_LIST *list;
 112      int foreground;
 113 {
 114   sigset_t set, oset;
 115   int job, status, old_async_pid;
 116
 117   BLOCK_CHILD (set, oset);
 118   job = get_job_spec (list);
 119
 120   if (job < 0 || job >= job_slots || jobs[job] == 0)
 121     {
 122       if (job != DUP_JOB)
 123         sh_badjob (list ? list->word->word : "current");
 124
 125       goto failure;
 126     }
 127
 128   /* Or if jobs[job]->pgrp == shell_pgrp. */
 129   if (IS_JOBCONTROL (job) == 0)
 130     {
 131       builtin_error ("job %%%d started without job control", job + 1);
 132       goto failure;
 133     }
 134
 135   if (foreground == 0)
 136     {
 137       old_async_pid = last_asynchronous_pid;
 138       last_asynchronous_pid = jobs[job]->pgrp;  /* As per Posix.2 5.4.2 */
 139     }
 140
 141   status = start_job (job, foreground);
 142
 143   if (status >= 0)
 144     {
 145     /* win: */
 146       UNBLOCK_CHILD (oset);
 147       return (status);
 148     }
 149   else
 150     {
 151       if (foreground == 0)
 152         last_asynchronous_pid = old_async_pid;
 153
 154     failure:
 155       UNBLOCK_CHILD (oset);
 156       return (EXECUTION_FAILURE);
 157     }
 158 }
 159 #endif /* JOB_CONTROL */