#include "suricata-common.h"
#include "suricata.h"
#include "util-debug.h"
#include "util-path.h"

Include dependency graph for util-path.c:

Macros
#define	DIRECTORY_SEPARATOR '/'

Functions
int	PathIsAbsolute (const char *path)
	Check if a path is absolute. More...

int	PathIsRelative (const char *path)
	Check if a path is relative. More...

int	PathMerge (char out_buf, size_t buf_size, const char const dir, const char *const fname)

char *	PathMergeAlloc (const char const dir, const char const fname)

int	PathJoin (char out_buf, size_t buf_size, const char const dir, const char *const fname)
	Wrapper to join a directory and filename and resolve using realpath _fullpath is used for WIN32. More...

int	SCDefaultMkDir (const char *path)
	Wrapper around SCMkDir with default mode arguments. More...

int	SCCreateDirectoryTree (const char *path, const bool final)
	Recursively create a directory. More...

bool	SCPathExists (const char *path)
	Check if a path exists. More...

bool	SCIsRegularDirectory (const struct dirent *const dir_entry)
	OS independent wrapper for directory check. More...

bool	SCIsRegularFile (const struct dirent *const dir_entry)
	OS independent to check for regular file. More...

char *	SCRealPath (const char path, char resolved_path)
	OS independent wrapper for realpath. More...

const char *	SCBasename (const char *path)

bool	SCPathContainsTraversal (const char *path)
	Check for directory traversal. More...

Detailed Description

Author: Victor Julien victo.nosp@m.r@in.nosp@m.linia.nosp@m.c.ne.nosp@m.t

Definition in file util-path.c.

Macro Definition Documentation

◆ DIRECTORY_SEPARATOR

#define DIRECTORY_SEPARATOR '/'

Definition at line 34 of file util-path.c.

Function Documentation

◆ PathIsAbsolute()

int PathIsAbsolute ( const char * path )

Check if a path is absolute.

Parameters

path	string with the path

Return values

1	absolute
0	not absolute

Definition at line 44 of file util-path.c.

Referenced by ConfYamlHandleInclude(), PathIsRelative(), SCConfLogOpenGeneric(), SCProfilingKeywordsGlobalInit(), SCProfilingPrefilterGlobalInit(), and SCProfilingSghsGlobalInit().

Here is the caller graph for this function:

◆ PathIsRelative()

int PathIsRelative ( const char * path )

Check if a path is relative.

Parameters

path	string with the path

Return values

1	relative
0	not relative

Definition at line 69 of file util-path.c.

References PathIsAbsolute().

Referenced by DetectLoadCompleteSigPath().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PathJoin()

int PathJoin	(	char *	out_buf,
		size_t	buf_size,
		const char *const	dir,
		const char *const	fname
	)

Wrapper to join a directory and filename and resolve using realpath _fullpath is used for WIN32.

Parameters

out_buf	output buffer. Up to PATH_MAX will be written. Unchanged on exit failure.
buf_size	length of output buffer, must be PATH_MAX
dir	the directory
fname	the filename

Return values

0	on success
-1	on failure

Definition at line 132 of file util-path.c.

References PathMerge(), SCEnter, SCLogError, SCRealPath(), and strlcpy().

Here is the call graph for this function:

◆ PathMerge()

int PathMerge	(	char *	out_buf,
		size_t	buf_size,
		const char *const	dir,
		const char *const	fname
	)

Definition at line 74 of file util-path.c.

References strlcat(), and strlcpy().

Referenced by PathJoin(), and PathMergeAlloc().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PathMergeAlloc()

char* PathMergeAlloc	(	const char *const	dir,
		const char *const	fname
	)

Definition at line 107 of file util-path.c.

References PathMerge(), and SCStrdup.

Referenced by DetectLoadCompleteSigPath().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SCBasename()

const char* SCBasename ( const char * path )

Definition at line 285 of file util-path.c.

References DIRECTORY_SEPARATOR.

◆ SCCreateDirectoryTree()

int SCCreateDirectoryTree	(	const char *	path,
		const bool	final
	)

Recursively create a directory.

Parameters

path	Path to create
final	true will create the final path component, false will not

Return values

0	on success
-1	on error

Definition at line 173 of file util-path.c.

References len, SCDefaultMkDir(), and strlcpy().

Here is the call graph for this function:

◆ SCDefaultMkDir()

int SCDefaultMkDir ( const char * path )

Wrapper around SCMkDir with default mode arguments.

Definition at line 159 of file util-path.c.

References SCMkDir.

Referenced by SCCreateDirectoryTree().

Here is the caller graph for this function:

◆ SCIsRegularDirectory()

bool SCIsRegularDirectory ( const struct dirent *const dir_entry )

OS independent wrapper for directory check.

Parameters

dir_entry object to check

Return values

True	if the object is a regular directory, otherwise false. This directory and parent directory will return false.

Definition at line 236 of file util-path.c.

◆ SCIsRegularFile()

bool SCIsRegularFile ( const struct dirent *const dir_entry )

OS independent to check for regular file.

Parameters

dir_entry object to check

Return values

True	if the object is a regular file. Otherwise false.

Definition at line 254 of file util-path.c.

◆ SCPathContainsTraversal()

bool SCPathContainsTraversal ( const char * path )

Check for directory traversal.

Parameters

path	The path string to check for traversal

Return values

true	if directory traversal is found, otherwise false

Definition at line 307 of file util-path.c.

◆ SCPathExists()

bool SCPathExists ( const char * path )

Check if a path exists.

Parameters

Path	to check for existence

Return values

true	if path exists
false	if path does not exist

Definition at line 219 of file util-path.c.

◆ SCRealPath()

char* SCRealPath	(	const char *	path,
		char *	resolved_path
	)

OS independent wrapper for realpath.

Parameters

path	the path to resolve
resolved_path	the resolved path; if null, a buffer will be allocated

Return values

the	resolved_path; or a pointer to a new resolved_path buffer

Definition at line 270 of file util-path.c.

Referenced by PathJoin().

Here is the caller graph for this function:

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ DIRECTORY_SEPARATOR

Function Documentation

◆ PathIsAbsolute()

◆ PathIsRelative()

◆ PathJoin()

◆ PathMerge()

◆ PathMergeAlloc()

◆ SCBasename()

◆ SCCreateDirectoryTree()

◆ SCDefaultMkDir()

◆ SCIsRegularDirectory()

◆ SCIsRegularFile()

◆ SCPathContainsTraversal()

◆ SCPathExists()

◆ SCRealPath()