{"id":7039,"date":"2022-12-20T19:34:43","date_gmt":"2022-12-20T22:34:43","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/manatoolssharedrunprogram-man3\/"},"modified":"2022-12-20T19:34:43","modified_gmt":"2022-12-20T22:34:43","slug":"manatoolssharedrunprogram-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/manatoolssharedrunprogram-man3\/","title":{"rendered":"ManaTools::Shared::RunProgram (man3)"},"content":{"rendered":"

ManaTools::Shared::RunProgram<\/h1>\n

SYNOPSYS<\/a>
Functions<\/a>
POD ERRORS<\/a> <\/p>\n

\n

SYNOPSYS <\/a> <\/h2>\n

rManaTools::Shared::RunProgram<\/b> enables to:<\/p>\n\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

run programs in foreground or in background,<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

to retrieve their stdout or stderr<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

…<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Most functions exits in a normal form & a rooted one. e.g.:<\/p>\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

“run()” & “rooted()”<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

“get_stdout()” & “rooted_get_stdout()”<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Most functions exits in a normal form & one that die. e.g.:<\/p>\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

“run()” & “run_or_die()”<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

“rooted()” & “rooted_or_die()”<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

Functions <\/a> <\/h2>\n

set_default_timeout($seconds)<\/p>\n

Alters defaults timeout (eg for harddrake service)<\/p>\n

run_or_die($name, @args)<\/p>\n

Runs $name with @args parameterXs. Dies if it exit code is not 0.<\/p>\n

rooted_or_die($root, $name, @args)<\/p>\n

Similar to run_or_die()<\/b> but runs in chroot in $root<\/p>\n

get_stdout($name, @args)<\/p>\n

Similar to run_or_die()<\/b> but return stdout of program:<\/p>\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

a list of lines in list context<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

a string of concatenated lines in scalar context<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

get_stdout_raw($options, $name, @args)<\/p>\n

Similar to get_stdout()<\/b> but allow to pass options to raw()<\/b><\/p>\n

rooted_get_stdout($root, $name, @args)<\/p>\n

Similar to get_stdout()<\/b> but runs in chroot in $root<\/p>\n

run($name, @args)<\/p>\n

Runs $name with @args parameters.<\/p>\n

rooted($root, $name, @args)<\/p>\n

Similar to run()<\/b> but runs in chroot in $root<\/p>\n

raw($options, $name, @args)<\/p>\n

The function used by all the other, making every combination possible. Runs $name with @args parameters. $options is a hash ref that can contains:<\/p>\n\n\n\n\n\n\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

root<\/b>: $name will be chrooted in $root prior to run<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

as_user<\/b>: $name will be run as $ENV{ PKEXEC_UID<\/small> } or with the UID<\/small> of parent process. Implies setuid<\/i><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

sensitive_arguments<\/b>: parameters will be hidden in logs (b\/c eg there\u2019s a password)<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

detach<\/b>: $name will be run in the background. Default is foreground<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

chdir<\/b>: $name will be run in a different default directory<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

setuid<\/b>: contains a getpwnam<\/b>(3) struct ; $name will be with droped privileges ; make sure environment is set right and keep a copy of the X11 cookie<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

timeout<\/b>: execution of $name will be aborted after “timeout” seconds<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

exitcode<\/b>: function will return the exit code of the process<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

eg:<\/p>\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

“ManaTools::Shared::RunProgram::raw({ root => $::prefix, sensitive_arguments => 1 }, “echo \u2212e $user\u2212>{password} | cryptsetup luksFormat $device”);”<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

“ManaTools::Shared::RunProgram::raw({ detach => 1 }, ‘\/etc\/rc.d\/init.d\/dm’, ‘>’, ‘\/dev\/null’, ‘2>’, ‘\/dev\/null’, ‘restart’);”<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

get_parent_uid()<\/b><\/p>\n

Returns UID<\/small> of the parent process.<\/p>\n

POD ERRORS <\/a> <\/h2>\n

Hey! The above document had some coding errors, which are explained below:<\/b>
Around line 58:<\/p>\n

=over without closing =back<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

ManaTools::Shared::RunProgram SYNOPSYS Functions POD ERRORS SYNOPSYS rManaTools::Shared::RunProgram enables to: \u2022 run programs in foreground or in background, \u2022 to retrieve their stdout or stderr \u2022 … Most functions exits in a normal form & a rooted one. e.g.: \u2022 “run()” & “rooted()” \u2022 “get_stdout()” & “rooted_get_stdout()” Most functions exits in a normal form & one […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3007,3386],"class_list":["post-7039","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-man3","tag-manatoolssharedrunprogram"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7039","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7039"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7039\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7039"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7039"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7039"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}