kc3-lang/gnulib/lib/execute.h

• Show log

  Commit

• Hash : c893594d
  Author :
  Date : 2020-12-12T04:18:54
  

  sh-quote, execute, spawn-pipe, etc.: Make better use of 'const'.
  
  * lib/sh-quote.h (shell_quote_argv): Does not need write access to the
  elements of argv.
  * lib/sh-quote.c (shell_quote_argv): Likewise.
  * lib/windows-spawn.h (prepare_spawn): Add 'const' the argument type and
  the return type.
  * lib/windows-spawn.c (prepare_spawn): Likewise.
  * lib/os2-spawn.h (prepare_spawn): Likewise.
  * lib/os2-spawn.c (prepare_spawn): Likewise.
  * lib/execute.h (execute): Does not need write access to the elements of
  prog_argv.
  * lib/execute.c (execute): Likewise.
  * lib/spawn-pipe.h (create_pipe_out, create_pipe_in, create_pipe_bidi):
  Likewise.
  * lib/spawn-pipe.c (create_pipe, create_pipe_bidi, create_pipe_in,
  create_pipe_out): Likewise.
  * lib/pipe-filter.h (pipe_filter_ii_execute, pipe_filter_gi_create):
  Likewise.
  * lib/pipe-filter-ii.c (pipe_filter_ii_execute): Likewise.
  * lib/pipe-filter-gi.c (pipe_filter_gi_create): Likewise.
  * lib/javaexec.h (execute_fn): Does not need write access to the
  elements of prog_argv.
  * lib/javaexec.c (execute_java_class): Update variable types and remove
  casts to 'char *'.
  * lib/csharpexec.h (execute_fn): Does not need write access to the
  elements of prog_argv.
  * lib/csharpexec.c (execute_csharp_using_mono,
  execute_csharp_using_sscli): Update variable types and remove casts to
  'char *'.
  * lib/javacomp.c (compile_using_envjavac, compile_using_gcj,
  compile_using_javac, compile_using_jikes, is_envjavac_gcj,
  is_envjavac_gcj43, is_gcj_present, is_gcj_43, is_javac_present,
  is_jikes_present): Update variable types and remove casts to 'char *'.
  * lib/javaversion.c (execute_and_read_line): Does not need write access
  to the elements of prog_argv.
  * lib/csharpcomp.c (compile_csharp_using_mono,
  compile_csharp_using_sscli): Update variable types and remove casts to
  'char *'.
  * tests/test-sh-quote.c (main): Update variable types and remove casts
  to 'char *'.
  * tests/test-execute-main.c (main): Update variable types and remove
  casts to 'char *'.
  * tests/test-spawn-pipe-main.c (test_pipe): Update variable types and
  remove casts to 'char *'.
  * NEWS: Mention the changes.
  

Download

• lib/execute.h

• /* Creation of autonomous subprocesses.
     Copyright (C) 2001-2003, 2008-2020 Free Software Foundation, Inc.
     Written by Bruno Haible <haible@clisp.cons.org>, 2001.
  
     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 3 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, see <https://www.gnu.org/licenses/>.  */
  
  #ifndef _EXECUTE_H
  #define _EXECUTE_H
  
  #include <stdbool.h>
  
  /* Execute a command, optionally redirecting any of the three standard file
     descriptors to /dev/null.  Return its exit code.
     If it didn't terminate correctly, exit if exit_on_error is true, otherwise
     return 127.
     progname is the name of the program to be executed by the subprocess, used
     for error messages.
     prog_path is the file name of the program to be executed by the subprocess.
     If it contains no slashes, a search is conducted in $PATH.  An operating
     system dependent suffix is added, if necessary.
     prog_argv is the array of strings that the subprocess shall receive in
     argv[].  It is a NULL-terminated array.  prog_argv[0] should normally be
     identical to prog_path.
     If directory is not NULL, the command is executed in that directory.  If
     prog_path is a relative file name, it resolved before changing to that
     directory.  The current directory of the current process remains unchanged.
     If ignore_sigpipe is true, consider a subprocess termination due to SIGPIPE
     as equivalent to a success.  This is suitable for processes whose only
     purpose is to write to standard output.
     If slave_process is true, the child process will be terminated when its
     creator receives a catchable fatal signal.
     If termsigp is not NULL, *termsig will be set to the signal that terminated
     the subprocess (if supported by the platform: not on native Windows
     platforms), otherwise 0.
     It is recommended that no signal is blocked or ignored while execute()
     is called.  See spawn-pipe.h for the reason.  */
  extern int execute (const char *progname,
                      const char *prog_path, const char * const *prog_argv,
                      const char *directory,
                      bool ignore_sigpipe,
                      bool null_stdin, bool null_stdout, bool null_stderr,
                      bool slave_process, bool exit_on_error,
                      int *termsigp);
  
  #endif /* _EXECUTE_H */
  

Download