[thirdparty/bash.git] / examples / loadables / realpath.c

/*
 * realpath -- canonicalize pathnames, resolving symlinks
 *
 * usage: realpath [-cqsv] [-a name] pathname [pathname...]
 *
 * options:	-a name	assign each canonicalized pathname to indexed array
 *			variable NAME
 *		-c	check whether or not each resolved path exists
 *		-q	no output, exit status determines whether path is valid
 *		-s	strip . and .. from the pathname only, no symlink resolution
 *		-v	produce verbose output
 *
 *
 * exit status:	0	if all pathnames resolved
 *		1	if any of the pathname arguments could not be resolved
 *
 *
 * Bash loadable builtin version
 *
 * Chet Ramey
 * chet@po.cwru.edu
 */

/*
   Copyright (C) 1999-2009,2021,2022 Free Software Foundation, Inc.

   This file is part of GNU Bash.
   Bash 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.

   Bash 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 Bash.  If not, see <http://www.gnu.org/licenses/>.
*/

#include "config.h"

#include <sys/types.h>
#include <sys/stat.h>

#include <stdio.h>
#ifdef HAVE_UNISTD_H
#  include <unistd.h>
#endif
#include "bashansi.h"
#include <maxpath.h>
#include <errno.h>

#include "builtins.h"
#include "shell.h"
#include "bashgetopt.h"
#include "common.h"

#ifndef errno
extern int	errno;
#endif

extern char	*sh_realpath();

int
realpath_builtin(WORD_LIST *list)
{
	int	opt, cflag, vflag, qflag, sflag, aflag, es;
	char	*r, realbuf[PATH_MAX], *p, *newpath;
	struct stat sb;
#if defined (ARRAY_VARS)
	arrayind_t	ind;
	char	*aname;
	SHELL_VAR	*v;
#endif

	if (list == 0) {
		builtin_usage();
		return (EX_USAGE);
	}

	vflag = cflag = qflag = aflag = sflag = 0;
#if defined (ARRAY_VARS)
	aname = NULL;
	v = NULL;
	ind = 0;
#endif
	reset_internal_getopt();
	while ((opt = internal_getopt (list, "a:cqsv")) != -1) {
		switch (opt) {
#if defined (ARRAY_VARS)
		case 'a':
			aflag = 1;
			aname = list_optarg;
			break;
#endif
		case 'c':
			cflag = 1;
			break;
		case 'q':
			qflag = 1;
			break;
		case 's':
			sflag = 1;
			break;
		case 'v':
			vflag = 1;
			break;
		CASE_HELPOPT;
		default:
			builtin_usage();
			return (EX_USAGE);
		}
	}

	list = loptend;

	if (list == 0) {
		builtin_usage();
		return (EX_USAGE);
	}

#if defined (ARRAY_VARS)
	if (aflag && legal_identifier (aname) == 0) {
		sh_invalidid(aname);
		return (EXECUTION_FAILURE);
	}
	if (aname && builtin_unbind_variable (aname) == -2)
		return (EXECUTION_FAILURE);
	if (aname) {
		v = find_or_make_array_variable (aname, 1);
		if (v == 0 || readonly_p (v) || noassign_p (v)) {
			if (v && readonly_p (v))
				err_readonly (aname);
			return (EXECUTION_FAILURE);
		} else if (array_p (v) == 0) {
			builtin_error ("%s: not an indexed array", aname);
			return (EXECUTION_FAILURE);
		}
		if (invisible_p (v))
			VUNSETATTR (v, att_invisible);
		array_flush (array_cell (v));
	}
#endif

	for (es = EXECUTION_SUCCESS; list; list = list->next) {
		p = list->word->word;
		if (sflag) {
			/* sh_canonpath doesn't convert to absolute pathnames */
			newpath = make_absolute(p, get_string_value("PWD"));
			r = sh_canonpath(newpath, PATH_CHECKDOTDOT|PATH_CHECKEXISTS);
			free(newpath);
		} else
			r = sh_realpath(p, realbuf);
		if (r == 0) {
			es = EXECUTION_FAILURE;
			if (qflag == 0)
				builtin_error("%s: cannot resolve: %s", p, strerror(errno));
			continue;
		}
		if (cflag && (stat(r, &sb) < 0)) {
			es = EXECUTION_FAILURE;
			if (qflag == 0)
				builtin_error("%s: %s", p, strerror(errno));
			continue;
		}
		if (aflag) {
			bind_array_element (v, ind, r, 0);
			ind++;
		}
		if (qflag == 0) {
			if (vflag)
				printf ("%s -> ", p);
			printf("%s\n", r);
		}
		if (sflag)
			free (r);
	}
	return es;
}

char *realpath_doc[] = {
	"Display pathname in canonical form.",
	"",
	"Display the canonicalized version of each PATHNAME argument, resolving",
	"symbolic links.",
	"The -a option stores each canonicalized PATHNAME argument into the indexed",
	"array VARNAME.",
	"The -c option checks whether or not each resolved name exists.",
	"The -q option produces no output; the exit status determines the",
	"validity of each PATHNAME, but any array assignment is still performed.",
	"If the -s option is supplied, canonicalize . and .. pathname components",
	"without resolving symbolic links.",
	"The -v option produces verbose output.",
	"The exit status is 0 if each PATHNAME was resolved; non-zero otherwise.",
	(char *)NULL
};

struct builtin realpath_struct = {
	"realpath",		/* builtin name */
	realpath_builtin,	/* function implementing the builtin */
	BUILTIN_ENABLED,	/* initial flags for builtin */
	realpath_doc,		/* array of long documentation strings */
	"realpath [-a varname] [-cqsv] pathname [pathname...]",	/* usage synopsis */
	0			/* reserved for internal use */
};
Commit	Line	Data
28ef6c31 JA	1	/*
	2	* realpath -- canonicalize pathnames, resolving symlinks
	3	*
74091dd4	4	* usage: realpath [-cqsv] [-a name] pathname [pathname...]
28ef6c31	5	*
74091dd4 CR	6	* options: -a name assign each canonicalized pathname to indexed array
	7	* variable NAME
	8	* -c check whether or not each resolved path exists
	9	* -q no output, exit status determines whether path is valid
	10	* -s strip . and .. from the pathname only, no symlink resolution
28ef6c31 JA	11	* -v produce verbose output
	12	*
	13	*
	14	* exit status: 0 if all pathnames resolved
	15	* 1 if any of the pathname arguments could not be resolved
	16	*
	17	*
	18	* Bash loadable builtin version
	19	*
	20	* Chet Ramey
	21	* chet@po.cwru.edu
	22	*/
	23
3185942a	24	/*
74091dd4	25	Copyright (C) 1999-2009,2021,2022 Free Software Foundation, Inc.
3185942a JA	26
	27	This file is part of GNU Bash.
	28	Bash is free software: you can redistribute it and/or modify
	29	it under the terms of the GNU General Public License as published by
	30	the Free Software Foundation, either version 3 of the License, or
	31	(at your option) any later version.
	32
	33	Bash is distributed in the hope that it will be useful,
	34	but WITHOUT ANY WARRANTY; without even the implied warranty of
	35	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	36	GNU General Public License for more details.
	37
	38	You should have received a copy of the GNU General Public License
	39	along with Bash. If not, see <http://www.gnu.org/licenses/>.
	40	*/
	41
28ef6c31 JA	42	#include "config.h"
	43
	44	#include <sys/types.h>
	45	#include <sys/stat.h>
	46
	47	#include <stdio.h>
	48	#ifdef HAVE_UNISTD_H
	49	# include <unistd.h>
	50	#endif
	51	#include "bashansi.h"
	52	#include <maxpath.h>
	53	#include <errno.h>
	54
	55	#include "builtins.h"
	56	#include "shell.h"
	57	#include "bashgetopt.h"
3185942a	58	#include "common.h"
28ef6c31 JA	59
	60	#ifndef errno
	61	extern int errno;
	62	#endif
	63
	64	extern char *sh_realpath();
	65
a0c0a00f	66	int
74091dd4	67	realpath_builtin(WORD_LIST *list)
28ef6c31	68	{
74091dd4 CR	69	int opt, cflag, vflag, qflag, sflag, aflag, es;
74091dd4 CR	70	char r, realbuf[PATH_MAX], p, *newpath;
28ef6c31	71	struct stat sb;
74091dd4 CR	72	#if defined (ARRAY_VARS)
	73	arrayind_t ind;
	74	char *aname;
	75	SHELL_VAR *v;
	76	#endif
28ef6c31 JA	77
	78	if (list == 0) {
	79	builtin_usage();
	80	return (EX_USAGE);
	81	}
	82
74091dd4 CR	83	vflag = cflag = qflag = aflag = sflag = 0;
	84	#if defined (ARRAY_VARS)
	85	aname = NULL;
	86	v = NULL;
	87	ind = 0;
	88	#endif
28ef6c31	89	reset_internal_getopt();
74091dd4	90	while ((opt = internal_getopt (list, "a:cqsv")) != -1) {
28ef6c31	91	switch (opt) {
74091dd4 CR	92	#if defined (ARRAY_VARS)
	93	case 'a':
	94	aflag = 1;
	95	aname = list_optarg;
	96	break;
	97	#endif
28ef6c31 JA	98	case 'c':
	99	cflag = 1;
	100	break;
74091dd4 CR	101	case 'q':
	102	qflag = 1;
	103	break;
28ef6c31 JA	104	case 's':
	105	sflag = 1;
	106	break;
	107	case 'v':
	108	vflag = 1;
	109	break;
d233b485	110	CASE_HELPOPT;
28ef6c31	111	default:
3185942a	112	builtin_usage();
d233b485	113	return (EX_USAGE);
28ef6c31 JA	114	}
	115	}
	116
	117	list = loptend;
	118
d233b485	119	if (list == 0) {
3185942a	120	builtin_usage();
d233b485 CR	121	return (EX_USAGE);
d233b485 CR	122	}
28ef6c31	123
74091dd4 CR	124	#if defined (ARRAY_VARS)
	125	if (aflag && legal_identifier (aname) == 0) {
	126	sh_invalidid(aname);
	127	return (EXECUTION_FAILURE);
	128	}
	129	if (aname && builtin_unbind_variable (aname) == -2)
	130	return (EXECUTION_FAILURE);
	131	if (aname) {
	132	v = find_or_make_array_variable (aname, 1);
	133	if (v == 0 \|\| readonly_p (v) \|\| noassign_p (v)) {
	134	if (v && readonly_p (v))
	135	err_readonly (aname);
	136	return (EXECUTION_FAILURE);
	137	} else if (array_p (v) == 0) {
	138	builtin_error ("%s: not an indexed array", aname);
	139	return (EXECUTION_FAILURE);
	140	}
	141	if (invisible_p (v))
	142	VUNSETATTR (v, att_invisible);
	143	array_flush (array_cell (v));
	144	}
	145	#endif
	146
28ef6c31 JA	147	for (es = EXECUTION_SUCCESS; list; list = list->next) {
28ef6c31 JA	148	p = list->word->word;
74091dd4 CR	149	if (sflag) {
	150	/* sh_canonpath doesn't convert to absolute pathnames */
	151	newpath = make_absolute(p, get_string_value("PWD"));
	152	r = sh_canonpath(newpath, PATH_CHECKDOTDOT\|PATH_CHECKEXISTS);
	153	free(newpath);
	154	} else
	155	r = sh_realpath(p, realbuf);
28ef6c31 JA	156	if (r == 0) {
28ef6c31 JA	157	es = EXECUTION_FAILURE;
74091dd4	158	if (qflag == 0)
28ef6c31 JA	159	builtin_error("%s: cannot resolve: %s", p, strerror(errno));
	160	continue;
	161	}
74091dd4	162	if (cflag && (stat(r, &sb) < 0)) {
28ef6c31	163	es = EXECUTION_FAILURE;
74091dd4	164	if (qflag == 0)
28ef6c31 JA	165	builtin_error("%s: %s", p, strerror(errno));
	166	continue;
	167	}
74091dd4 CR	168	if (aflag) {
	169	bind_array_element (v, ind, r, 0);
	170	ind++;
	171	}
	172	if (qflag == 0) {
28ef6c31 JA	173	if (vflag)
28ef6c31 JA	174	printf ("%s -> ", p);
74091dd4	175	printf("%s\n", r);
28ef6c31	176	}
74091dd4 CR	177	if (sflag)
74091dd4 CR	178	free (r);
28ef6c31 JA	179	}
	180	return es;
	181	}
	182
	183	char *realpath_doc[] = {
3185942a JA	184	"Display pathname in canonical form.",
3185942a JA	185	"",
28ef6c31	186	"Display the canonicalized version of each PATHNAME argument, resolving",
74091dd4 CR	187	"symbolic links.",
	188	"The -a option stores each canonicalized PATHNAME argument into the indexed",
	189	"array VARNAME.",
	190	"The -c option checks whether or not each resolved name exists.",
	191	"The -q option produces no output; the exit status determines the",
	192	"validity of each PATHNAME, but any array assignment is still performed.",
	193	"If the -s option is supplied, canonicalize . and .. pathname components",
	194	"without resolving symbolic links.",
	195	"The -v option produces verbose output.",
	196	"The exit status is 0 if each PATHNAME was resolved; non-zero otherwise.",
28ef6c31 JA	197	(char *)NULL
	198	};
	199
	200	struct builtin realpath_struct = {
	201	"realpath", /* builtin name */
	202	realpath_builtin, /* function implementing the builtin */
	203	BUILTIN_ENABLED, /* initial flags for builtin */
	204	realpath_doc, /* array of long documentation strings */
74091dd4	205	"realpath [-a varname] [-cqsv] pathname [pathname...]", /* usage synopsis */
28ef6c31 JA	206	0 /* reserved for internal use */
28ef6c31 JA	207	};