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-2003 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 "../bashintl.h"
  43
  44 #include "../shell.h"
  45 #include "../jobs.h"
  46 #include "common.h"
  47 #include "bashgetopt.h"
  48
  49 #if defined (JOB_CONTROL)
  50 extern char *this_command_name;
  51
  52 static int fg_bg __P((WORD_LIST *, int));
  53
  54 /* How to bring a job into the foreground. */
  55 int
  56 fg_builtin (list)
  57      WORD_LIST *list;
  58 {
  59   int fg_bit;
  60   register WORD_LIST *t;
  61
  62   if (job_control == 0)
  63     {
  64       sh_nojobs ((char *)NULL);
  65       return (EXECUTION_FAILURE);
  66     }
  67
  68   if (no_options (list))
  69     return (EX_USAGE);
  70   list = loptend;
  71
  72   /* If the last arg on the line is '&', then start this job in the
  73      background.  Else, fg the job. */
  74   for (t = list; t && t->next; t = t->next)
  75     ;
  76   fg_bit = (t && t->word->word[0] == '&' && t->word->word[1] == '\0') == 0;
  77
  78   return (fg_bg (list, fg_bit));
  79 }
  80 #endif /* JOB_CONTROL */
  81
  82 $BUILTIN bg
  83 $FUNCTION bg_builtin
  84 $DEPENDS_ON JOB_CONTROL
  85 $SHORT_DOC bg [job_spec]
  86 Place JOB_SPEC in the background, as if it had been started with
  87 `&'.  If JOB_SPEC is not present, the shell's notion of the current
  88 job is used.
  89 $END
  90
  91 #if defined (JOB_CONTROL)
  92 /* How to put a job into the background. */
  93 int
  94 bg_builtin (list)
  95      WORD_LIST *list;
  96 {
  97   if (job_control == 0)
  98     {
  99       sh_nojobs ((char *)NULL);
 100       return (EXECUTION_FAILURE);
 101     }
 102
 103   if (no_options (list))
 104     return (EX_USAGE);
 105   list = loptend;
 106
 107   return (fg_bg (list, 0));
 108 }
 109
 110 /* How to put a job into the foreground/background. */
 111 static int
 112 fg_bg (list, foreground)
 113      WORD_LIST *list;
 114      int foreground;
 115 {
 116   sigset_t set, oset;
 117   int job, status, old_async_pid;
 118
 119   BLOCK_CHILD (set, oset);
 120   job = get_job_spec (list);
 121
 122   if (job < 0 || job >= job_slots || jobs[job] == 0)
 123     {
 124       if (job != DUP_JOB)
 125         sh_badjob (list ? list->word->word : "current");
 126
 127       goto failure;
 128     }
 129
 130   /* Or if jobs[job]->pgrp == shell_pgrp. */
 131   if (IS_JOBCONTROL (job) == 0)
 132     {
 133       builtin_error (_("job %d started without job control"), job + 1);
 134       goto failure;
 135     }
 136
 137   if (foreground == 0)
 138     {
 139       old_async_pid = last_asynchronous_pid;
 140       last_asynchronous_pid = jobs[job]->pgrp;  /* As per Posix.2 5.4.2 */
 141     }
 142
 143   status = start_job (job, foreground);
 144
 145   if (status >= 0)
 146     {
 147     /* win: */
 148       UNBLOCK_CHILD (oset);
 149       return (status);
 150     }
 151   else
 152     {
 153       if (foreground == 0)
 154         last_asynchronous_pid = old_async_pid;
 155
 156     failure:
 157       UNBLOCK_CHILD (oset);
 158       return (EXECUTION_FAILURE);
 159     }
 160 }
 161 #endif /* JOB_CONTROL */