1999-04-17 08:37:12 +08:00
|
|
|
/*
|
|
|
|
+----------------------------------------------------------------------+
|
1999-07-16 21:13:16 +08:00
|
|
|
| PHP version 4.0 |
|
1999-04-17 08:37:12 +08:00
|
|
|
+----------------------------------------------------------------------+
|
2000-01-01 09:32:05 +08:00
|
|
|
| Copyright (c) 1997, 1998, 1999, 2000 The PHP Group |
|
1999-04-17 08:37:12 +08:00
|
|
|
+----------------------------------------------------------------------+
|
2000-02-20 07:41:32 +08:00
|
|
|
| This source file is subject to version 2.01 of the PHP license, |
|
1999-07-16 21:13:16 +08:00
|
|
|
| that is bundled with this package in the file LICENSE, and is |
|
|
|
|
| available at through the world-wide-web at |
|
2000-02-20 07:41:32 +08:00
|
|
|
| http://www.php.net/license/2_01.txt. |
|
1999-07-16 21:13:16 +08:00
|
|
|
| If you did not receive a copy of the PHP license and are unable to |
|
|
|
|
| obtain it through the world-wide-web, please send a note to |
|
|
|
|
| license@php.net so we can mail you a copy immediately. |
|
1999-04-17 08:37:12 +08:00
|
|
|
+----------------------------------------------------------------------+
|
|
|
|
| Author: Rasmus Lerdorf |
|
|
|
|
+----------------------------------------------------------------------+
|
|
|
|
*/
|
|
|
|
/* $Id$ */
|
|
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
#include "php.h"
|
|
|
|
#include <ctype.h>
|
1999-12-05 03:19:57 +08:00
|
|
|
#include "php_string.h"
|
1999-04-17 08:37:12 +08:00
|
|
|
#include "safe_mode.h"
|
1999-04-22 08:25:57 +08:00
|
|
|
#include "ext/standard/head.h"
|
1999-04-17 08:37:12 +08:00
|
|
|
#include "exec.h"
|
|
|
|
#include "php_globals.h"
|
1999-04-27 01:26:37 +08:00
|
|
|
#include "SAPI.h"
|
1999-04-17 08:37:12 +08:00
|
|
|
|
|
|
|
#if HAVE_SYS_WAIT_H
|
|
|
|
#include <sys/wait.h>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/*
|
|
|
|
* If type==0, only last line of output is returned (exec)
|
|
|
|
* If type==1, all lines will be printed and last lined returned (system)
|
|
|
|
* If type==2, all lines will be saved to given array (exec with &$array)
|
|
|
|
* If type==3, output will be printed binary, no lines will be saved or returned (passthru)
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
static int _Exec(int type, char *cmd, pval *array, pval *return_value)
|
|
|
|
{
|
|
|
|
FILE *fp;
|
1999-07-21 04:19:58 +08:00
|
|
|
char *buf, *tmp=NULL;
|
|
|
|
int buflen = 0;
|
1999-04-17 08:37:12 +08:00
|
|
|
int t, l, ret, output=1;
|
|
|
|
int overflow_limit, lcmd, ldir;
|
|
|
|
char *b, *c, *d=NULL;
|
|
|
|
PLS_FETCH();
|
|
|
|
|
1999-07-21 04:19:58 +08:00
|
|
|
buf = (char*) emalloc(EXEC_INPUT_BUF);
|
|
|
|
if (!buf) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING, "Unable to emalloc %d bytes for exec buffer", EXEC_INPUT_BUF);
|
1999-07-21 04:19:58 +08:00
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
buflen = EXEC_INPUT_BUF;
|
|
|
|
|
1999-04-17 08:37:12 +08:00
|
|
|
if (PG(safe_mode)) {
|
|
|
|
lcmd = strlen(cmd);
|
|
|
|
ldir = strlen(PG(safe_mode_exec_dir));
|
|
|
|
l = lcmd + ldir + 2;
|
|
|
|
overflow_limit = l;
|
|
|
|
c = strchr(cmd, ' ');
|
|
|
|
if (c) *c = '\0';
|
|
|
|
if (strstr(cmd, "..")) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING, "No '..' components allowed in path");
|
1999-07-21 04:19:58 +08:00
|
|
|
efree(buf);
|
1999-04-17 08:37:12 +08:00
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
d = emalloc(l);
|
|
|
|
strcpy(d, PG(safe_mode_exec_dir));
|
|
|
|
overflow_limit -= ldir;
|
|
|
|
b = strrchr(cmd, '/');
|
|
|
|
if (b) {
|
|
|
|
strcat(d, b);
|
|
|
|
overflow_limit -= strlen(b);
|
|
|
|
} else {
|
|
|
|
strcat(d, "/");
|
|
|
|
strcat(d, cmd);
|
|
|
|
overflow_limit-=(strlen(cmd)+1);
|
|
|
|
}
|
|
|
|
if (c) {
|
|
|
|
*c = ' ';
|
|
|
|
strncat(d, c, overflow_limit);
|
|
|
|
}
|
1999-12-18 12:01:20 +08:00
|
|
|
tmp = php_escape_shell_cmd(d);
|
1999-04-17 08:37:12 +08:00
|
|
|
efree(d);
|
|
|
|
d = tmp;
|
2000-02-11 23:59:30 +08:00
|
|
|
#ifdef PHP_WIN32
|
1999-04-17 08:37:12 +08:00
|
|
|
fp = popen(d, "rb");
|
|
|
|
#else
|
|
|
|
fp = popen(d, "r");
|
|
|
|
#endif
|
|
|
|
if (!fp) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING, "Unable to fork [%s]", d);
|
1999-04-17 08:37:12 +08:00
|
|
|
efree(d);
|
1999-07-21 04:19:58 +08:00
|
|
|
efree(buf);
|
1999-04-17 08:37:12 +08:00
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
} else { /* not safe_mode */
|
2000-02-11 23:59:30 +08:00
|
|
|
#ifdef PHP_WIN32
|
1999-04-17 08:37:12 +08:00
|
|
|
fp = popen(cmd, "rb");
|
|
|
|
#else
|
|
|
|
fp = popen(cmd, "r");
|
|
|
|
#endif
|
|
|
|
if (!fp) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING, "Unable to fork [%s]", cmd);
|
1999-07-21 04:19:58 +08:00
|
|
|
efree(buf);
|
1999-04-17 08:37:12 +08:00
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
buf[0] = '\0';
|
|
|
|
if (type==2) {
|
|
|
|
if (array->type != IS_ARRAY) {
|
1999-04-24 08:12:00 +08:00
|
|
|
pval_destructor(array);
|
1999-04-17 08:37:12 +08:00
|
|
|
array_init(array);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (type != 3) {
|
1999-07-21 04:19:58 +08:00
|
|
|
l=0;
|
|
|
|
while ( !feof(fp) || l != 0 ) {
|
|
|
|
l = 0;
|
|
|
|
/* Read a line or fill the buffer, whichever comes first */
|
|
|
|
do {
|
|
|
|
if ( buflen <= (l+1) ) {
|
|
|
|
buf = erealloc(buf, buflen + EXEC_INPUT_BUF);
|
|
|
|
if ( buf == NULL ) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING, "Unable to erealloc %d bytes for exec buffer",
|
1999-07-21 04:19:58 +08:00
|
|
|
buflen + EXEC_INPUT_BUF);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
buflen += EXEC_INPUT_BUF;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( fgets(&(buf[l]), buflen - l, fp) == NULL ) {
|
|
|
|
/* eof */
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
l += strlen(&(buf[l]));
|
|
|
|
} while ( (l > 0) && (buf[l-1] != '\n') );
|
|
|
|
|
|
|
|
if ( feof(fp) && (l == 0) ) {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
1999-04-17 08:37:12 +08:00
|
|
|
if (type == 1) {
|
|
|
|
if (output) PUTS(buf);
|
2000-02-11 03:41:21 +08:00
|
|
|
sapi_flush();
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
|
|
|
else if (type == 2) {
|
|
|
|
/* strip trailing whitespaces */
|
|
|
|
l = strlen(buf);
|
|
|
|
t = l;
|
1999-07-21 04:19:58 +08:00
|
|
|
while (l-- && isspace((int)buf[l]));
|
1999-06-02 00:41:56 +08:00
|
|
|
if (l < t) {
|
|
|
|
buf[l + 1] = '\0';
|
|
|
|
}
|
|
|
|
add_next_index_string(array, buf, 1);
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* strip trailing spaces */
|
|
|
|
l = strlen(buf);
|
|
|
|
t = l;
|
|
|
|
while (l && isspace((int)buf[--l]));
|
|
|
|
if (l < t) buf[l + 1] = '\0';
|
|
|
|
|
2000-02-23 02:00:32 +08:00
|
|
|
/* Return last line from the shell command */
|
|
|
|
if (PG(magic_quotes_runtime)) {
|
|
|
|
int len;
|
|
|
|
|
|
|
|
tmp = php_addslashes(buf, 0, &len, 0);
|
|
|
|
RETVAL_STRINGL(tmp,len,0);
|
|
|
|
} else
|
2000-03-06 23:32:05 +08:00
|
|
|
RETVAL_STRINGL(buf,l+1,1);
|
1999-04-17 08:37:12 +08:00
|
|
|
} else {
|
|
|
|
int b, i;
|
|
|
|
|
2000-02-12 03:16:36 +08:00
|
|
|
while ((b = fread(buf, 1, buflen, fp)) > 0) {
|
1999-04-17 08:37:12 +08:00
|
|
|
for (i = 0; i < b; i++)
|
1999-09-05 06:15:51 +08:00
|
|
|
if (output) (void)PUTC(buf[i]);
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
ret = pclose(fp);
|
|
|
|
#if HAVE_SYS_WAIT_H
|
|
|
|
if (WIFEXITED(ret)) {
|
|
|
|
ret = WEXITSTATUS(ret);
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
if (d) efree(d);
|
1999-07-21 04:19:58 +08:00
|
|
|
efree(buf);
|
1999-04-17 08:37:12 +08:00
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* {{{ proto int exec(string command [, array output [, int return_value]])
|
|
|
|
Execute an external program */
|
1999-05-16 19:19:26 +08:00
|
|
|
PHP_FUNCTION(exec)
|
1999-04-17 08:37:12 +08:00
|
|
|
{
|
1999-12-20 09:23:15 +08:00
|
|
|
pval **arg1, **arg2, **arg3;
|
1999-04-17 08:37:12 +08:00
|
|
|
int arg_count = ARG_COUNT(ht);
|
|
|
|
int ret;
|
|
|
|
|
1999-12-20 09:23:15 +08:00
|
|
|
if (arg_count > 3 || zend_get_parameters_ex(arg_count, &arg1,&arg2, &arg3) == FAILURE) {
|
1999-04-17 08:37:12 +08:00
|
|
|
WRONG_PARAM_COUNT;
|
|
|
|
}
|
|
|
|
switch (arg_count) {
|
|
|
|
case 1:
|
1999-12-20 09:23:15 +08:00
|
|
|
ret = _Exec(0, (*arg1)->value.str.val, NULL,return_value);
|
1999-04-17 08:37:12 +08:00
|
|
|
break;
|
|
|
|
case 2:
|
|
|
|
if (!ParameterPassedByReference(ht,2)) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING,"Array argument to exec() not passed by reference");
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
1999-12-20 09:23:15 +08:00
|
|
|
ret = _Exec(2, (*arg1)->value.str.val,*arg2,return_value);
|
1999-04-17 08:37:12 +08:00
|
|
|
break;
|
|
|
|
case 3:
|
|
|
|
if (!ParameterPassedByReference(ht,2)) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING,"Array argument to exec() not passed by reference");
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
|
|
|
if (!ParameterPassedByReference(ht,3)) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING,"return_status argument to exec() not passed by reference");
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
1999-12-20 09:23:15 +08:00
|
|
|
ret = _Exec(2,(*arg1)->value.str.val,*arg2,return_value);
|
|
|
|
(*arg3)->type = IS_LONG;
|
|
|
|
(*arg3)->value.lval=ret;
|
1999-04-17 08:37:12 +08:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
2000-03-06 23:32:05 +08:00
|
|
|
|
1999-04-17 08:37:12 +08:00
|
|
|
/* }}} */
|
|
|
|
|
|
|
|
/* {{{ proto int system(string command [, int return_value])
|
|
|
|
Execute an external program and display output */
|
1999-05-16 19:19:26 +08:00
|
|
|
PHP_FUNCTION(system)
|
1999-04-17 08:37:12 +08:00
|
|
|
{
|
1999-12-20 09:23:15 +08:00
|
|
|
pval **arg1, **arg2;
|
1999-04-17 08:37:12 +08:00
|
|
|
int arg_count = ARG_COUNT(ht);
|
|
|
|
int ret;
|
|
|
|
|
1999-12-20 09:23:15 +08:00
|
|
|
if (arg_count > 2 || zend_get_parameters_ex(arg_count, &arg1,&arg2) == FAILURE) {
|
1999-04-17 08:37:12 +08:00
|
|
|
WRONG_PARAM_COUNT;
|
|
|
|
}
|
|
|
|
switch (arg_count) {
|
|
|
|
case 1:
|
1999-12-20 09:23:15 +08:00
|
|
|
ret = _Exec(1, (*arg1)->value.str.val, NULL,return_value);
|
1999-04-17 08:37:12 +08:00
|
|
|
break;
|
|
|
|
case 2:
|
|
|
|
if (!ParameterPassedByReference(ht,2)) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING,"return_status argument to system() not passed by reference");
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
1999-12-20 09:23:15 +08:00
|
|
|
ret = _Exec(1, (*arg1)->value.str.val, NULL,return_value);
|
|
|
|
(*arg2)->type = IS_LONG;
|
|
|
|
(*arg2)->value.lval=ret;
|
1999-04-17 08:37:12 +08:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
/* }}} */
|
|
|
|
|
2000-02-12 03:19:06 +08:00
|
|
|
/* {{{ proto void passthru(string command [, int return_value])
|
1999-04-17 08:37:12 +08:00
|
|
|
Execute an external program and display raw output */
|
1999-05-16 19:19:26 +08:00
|
|
|
PHP_FUNCTION(passthru)
|
1999-04-17 08:37:12 +08:00
|
|
|
{
|
1999-12-20 09:23:15 +08:00
|
|
|
pval **arg1, **arg2;
|
1999-04-17 08:37:12 +08:00
|
|
|
int arg_count = ARG_COUNT(ht);
|
|
|
|
int ret;
|
|
|
|
|
1999-12-20 09:23:15 +08:00
|
|
|
if (arg_count > 2 || zend_get_parameters_ex(arg_count, &arg1,&arg2) == FAILURE) {
|
1999-04-17 08:37:12 +08:00
|
|
|
WRONG_PARAM_COUNT;
|
|
|
|
}
|
|
|
|
switch (arg_count) {
|
|
|
|
case 1:
|
1999-12-20 09:23:15 +08:00
|
|
|
ret = _Exec(3, (*arg1)->value.str.val, NULL,return_value);
|
1999-04-17 08:37:12 +08:00
|
|
|
break;
|
|
|
|
case 2:
|
|
|
|
if (!ParameterPassedByReference(ht,2)) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING,"return_status argument to system() not passed by reference");
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
1999-12-20 09:23:15 +08:00
|
|
|
ret = _Exec(3, (*arg1)->value.str.val, NULL,return_value);
|
|
|
|
(*arg2)->type = IS_LONG;
|
|
|
|
(*arg2)->value.lval=ret;
|
1999-04-17 08:37:12 +08:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
/* }}} */
|
|
|
|
|
1999-12-18 12:01:20 +08:00
|
|
|
static int php_get_index(char *s, char c)
|
1999-04-17 08:37:12 +08:00
|
|
|
{
|
|
|
|
register int x;
|
|
|
|
|
|
|
|
for (x = 0; s[x]; x++)
|
|
|
|
if (s[x] == c)
|
|
|
|
return x;
|
|
|
|
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Escape all chars that could possibly be used to
|
|
|
|
break out of a shell command
|
|
|
|
|
|
|
|
This function emalloc's a string and returns the pointer.
|
|
|
|
Remember to efree it when done with it.
|
|
|
|
|
|
|
|
*NOT* safe for binary strings
|
|
|
|
*/
|
1999-12-18 12:01:20 +08:00
|
|
|
char * php_escape_shell_cmd(char *str) {
|
1999-04-17 08:37:12 +08:00
|
|
|
register int x, y, l;
|
|
|
|
char *cmd;
|
|
|
|
|
|
|
|
l = strlen(str);
|
|
|
|
cmd = emalloc(2 * l + 1);
|
|
|
|
strcpy(cmd, str);
|
|
|
|
for (x = 0; cmd[x]; x++) {
|
1999-12-18 12:01:20 +08:00
|
|
|
if (php_get_index("&;`'\"|*?~<>^()[]{}$\\\x0A\xFF", cmd[x]) != -1) {
|
1999-04-17 08:37:12 +08:00
|
|
|
for (y = l + 1; y > x; y--)
|
|
|
|
cmd[y] = cmd[y - 1];
|
|
|
|
l++; /* length has been increased */
|
|
|
|
cmd[x] = '\\';
|
|
|
|
x++; /* skip the character */
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return cmd;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* {{{ proto escapeshellcmd(string command)
|
2000-02-24 16:07:29 +08:00
|
|
|
Escape shell metacharacters */
|
1999-05-16 19:19:26 +08:00
|
|
|
PHP_FUNCTION(escapeshellcmd)
|
1999-04-17 08:37:12 +08:00
|
|
|
{
|
1999-12-20 09:23:15 +08:00
|
|
|
pval **arg1;
|
1999-08-19 01:23:01 +08:00
|
|
|
char *cmd = NULL;
|
1999-04-17 08:37:12 +08:00
|
|
|
|
1999-12-20 09:23:15 +08:00
|
|
|
if (zend_get_parameters_ex(1, &arg1) == FAILURE) {
|
1999-04-17 08:37:12 +08:00
|
|
|
WRONG_PARAM_COUNT;
|
|
|
|
}
|
1999-08-19 01:23:01 +08:00
|
|
|
|
1999-12-20 09:23:15 +08:00
|
|
|
convert_to_string_ex(arg1);
|
|
|
|
if ((*arg1)->value.str.len) {
|
|
|
|
cmd = php_escape_shell_cmd((*arg1)->value.str.val);
|
1999-08-19 01:23:01 +08:00
|
|
|
RETVAL_STRING(cmd, 1);
|
|
|
|
efree(cmd);
|
|
|
|
}
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
|
|
|
/* }}} */
|
|
|
|
|
|
|
|
|
|
|
|
PHP_FUNCTION(shell_exec)
|
|
|
|
{
|
|
|
|
FILE *in;
|
|
|
|
int readbytes,total_readbytes=0,allocated_space;
|
1999-12-20 09:23:15 +08:00
|
|
|
pval **cmd;
|
1999-04-21 12:02:11 +08:00
|
|
|
PLS_FETCH();
|
1999-04-17 08:37:12 +08:00
|
|
|
|
1999-12-20 09:23:15 +08:00
|
|
|
if (ARG_COUNT(ht)!=1 || zend_get_parameters_ex(1,&cmd)==FAILURE) {
|
1999-04-17 08:37:12 +08:00
|
|
|
WRONG_PARAM_COUNT;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (PG(safe_mode)) {
|
1999-08-03 03:17:14 +08:00
|
|
|
php_error(E_WARNING,"Cannot execute using backquotes in safe mode");
|
1999-04-17 08:37:12 +08:00
|
|
|
RETURN_FALSE;
|
|
|
|
}
|
|
|
|
|
1999-12-20 09:23:15 +08:00
|
|
|
convert_to_string_ex(cmd);
|
2000-02-11 23:59:30 +08:00
|
|
|
#ifdef PHP_WIN32
|
1999-12-20 09:23:15 +08:00
|
|
|
if ((in=popen((*cmd)->value.str.val,"rt"))==NULL) {
|
1999-04-17 08:37:12 +08:00
|
|
|
#else
|
1999-12-20 09:23:15 +08:00
|
|
|
if ((in=popen((*cmd)->value.str.val,"r"))==NULL) {
|
1999-04-17 08:37:12 +08:00
|
|
|
#endif
|
1999-12-20 09:23:15 +08:00
|
|
|
php_error(E_WARNING,"Unable to execute '%s'",(*cmd)->value.str.val);
|
1999-04-17 08:37:12 +08:00
|
|
|
}
|
|
|
|
allocated_space = EXEC_INPUT_BUF;
|
|
|
|
return_value->value.str.val = (char *) emalloc(allocated_space);
|
|
|
|
while (1) {
|
|
|
|
readbytes = fread(return_value->value.str.val+total_readbytes,1,EXEC_INPUT_BUF,in);
|
|
|
|
if (readbytes<=0) {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
total_readbytes += readbytes;
|
|
|
|
allocated_space = total_readbytes+EXEC_INPUT_BUF;
|
|
|
|
return_value->value.str.val = (char *) erealloc(return_value->value.str.val,allocated_space);
|
|
|
|
}
|
1999-10-13 22:01:47 +08:00
|
|
|
pclose(in);
|
1999-04-17 08:37:12 +08:00
|
|
|
|
|
|
|
return_value->value.str.val = erealloc(return_value->value.str.val,total_readbytes+1);
|
|
|
|
return_value->value.str.val[total_readbytes]=0;
|
|
|
|
return_value->value.str.len = total_readbytes;
|
|
|
|
return_value->type = IS_STRING;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Local variables:
|
|
|
|
* tab-width: 4
|
|
|
|
* c-basic-offset: 4
|
|
|
|
* End:
|
|
|
|
*/
|