:orphan:

.. index:: pair: group; Call shell commands
.. _doxid-group__te__tools__te__shell__cmd:

Call shell commands
===================

.. toctree::
	:hidden:

Overview
~~~~~~~~

Routines to call shell commands

Copyright (C) 2004-2022 OKTET Labs Ltd. :ref:`More...<details-group__te__tools__te__shell__cmd>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	
	// global functions

	pid_t :ref:`te_shell_cmd<doxid-group__te__tools__te__shell__cmd_1gafa75d04899103822bae17419381868ca>`(const char* cmd, uid_t uid, int* in_fd, int* out_fd, int* err_fd);

.. _details-group__te__tools__te__shell__cmd:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

Routines to call shell commands

Copyright (C) 2004-2022 OKTET Labs Ltd. All rights reserved.

Global Functions
----------------

.. index:: pair: function; te_shell_cmd
.. _doxid-group__te__tools__te__shell__cmd_1gafa75d04899103822bae17419381868ca:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	pid_t te_shell_cmd(const char* cmd, uid_t uid, int* in_fd, int* out_fd, int* err_fd)

Function to base system()-like and popen()-like functions on it. You MUST use uid parameter instead of "su - user -c", because su makes one more fork, and you do not know how to kill this grandchild process.

If you use this fuction from agent, this process SHOULD be catched by :ref:`ta_waitpid() <doxid-agentlib_8h_1a8b56d9d4063ec1bd6f6192b95119209d>` or killed by :ref:`ta_kill_death() <doxid-agentlib_8h_1a7e3ade98e2443c470a125e0d0cbc1de4>`.



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- cmd

		- command to run in the shell

	*
		- uid

		- user id to run the shell; use -1 for default

	*
		- in_fd

		- location to store file descriptor of pipe to stdin of the shell command; use NULL for standard stdin

	*
		- out_fd

		- location to store file descriptor of pipe to stdout of the shell command; use NULL for standard stdout

	*
		- err_fd

		- location to store file descriptor of pipe to stderr of the shell command; use NULL for standard stderr



.. rubric:: Returns:

pid value, positive on success, negative on failure