mirror of
https://github.com/fish-shell/fish-shell.git
synced 2024-11-29 13:23:53 +08:00
70 lines
2.4 KiB
C++
70 lines
2.4 KiB
C++
/** \file path.h
|
|
|
|
Directory utilities. This library contains functions for locating
|
|
configuration directories, for testing if a command with a given
|
|
name can be found in the PATH, and various other path-related
|
|
issues.
|
|
*/
|
|
|
|
#ifndef FISH_PATH_H
|
|
#define FISH_PATH_H
|
|
|
|
/**
|
|
Return value for path_cdpath_get when locatied a rotten symlink
|
|
*/
|
|
#define EROTTEN 1
|
|
|
|
/**
|
|
Returns the user configuration directory for fish. If the directory
|
|
or one of it's parents doesn't exist, they are first created.
|
|
|
|
\param context the halloc context to use for memory allocations
|
|
\return 0 if the no configuration directory can be located or created, the directory path otherwise.
|
|
*/
|
|
wchar_t *path_get_config( void *context);
|
|
bool path_get_config(wcstring &path);
|
|
|
|
/**
|
|
Finds the full path of an executable in a newly allocated string.
|
|
|
|
\param cmd The name of the executable.
|
|
\param context the halloc context to use for memory allocations
|
|
\return 0 if the command can not be found, the path of the command otherwise. The result should be freed with free().
|
|
*/
|
|
wchar_t *path_get_path( const wchar_t *cmd );
|
|
|
|
class env_vars;
|
|
bool path_get_path_string(const wcstring &cmd, wcstring &output, const env_vars &vars);
|
|
|
|
/**
|
|
Returns the full path of the specified directory, using the CDPATH
|
|
variable as a list of base directories for relative paths. The
|
|
returned string is allocated using halloc and the specified
|
|
context.
|
|
|
|
If no valid path is found, null is returned and errno is set to
|
|
ENOTDIR if at least one such path was found, but it did not point
|
|
to a directory, EROTTEN if a arotten symbolic link was found, or
|
|
ENOENT if no file of the specified name was found. If both a rotten
|
|
symlink and a file are found, it is undefined which error status
|
|
will be returned.
|
|
|
|
\param in The name of the directory.
|
|
\return 0 if the command can not be found, the path of the command otherwise. The path should be free'd with free().
|
|
*/
|
|
wchar_t *path_allocate_cdpath( const wchar_t *in );
|
|
bool path_can_get_cdpath(const wcstring &in);
|
|
bool path_get_cdpath_string(const wcstring &in, wcstring &out, const env_vars &vars);
|
|
|
|
/**
|
|
Remove doulbe slashes and trailing slashes from a path,
|
|
e.g. transform foo//bar/ into foo/bar.
|
|
|
|
The returned string is allocated using the specified halloc
|
|
context.
|
|
*/
|
|
wchar_t *path_make_canonical( void *context, const wchar_t *path );
|
|
|
|
|
|
#endif
|