perm.h File Reference

Functions to produce and parse the FreeRADIUS presentation format. More...

#include <pwd.h>
#include <sys/stat.h>
#include <sys/types.h>
#include <grp.h>
#include <freeradius-devel/util/talloc.h>

Include dependency graph for perm.h:

Go to the source code of this file.

Functions
void	fr_perm_file_error (int num)
	Write a file access error to the fr_strerror buffer, including euid/egid. More...
int	fr_perm_getgrgid (TALLOC_CTX *ctx, struct group **out, gid_t gid))
	Resolve a gid to a group database entry. More...
int	fr_perm_getgrnam (TALLOC_CTX *ctx, struct group **out, char const *name))
	Resolve a group name to a group database entry. More...
int	fr_perm_getpwnam (TALLOC_CTX *ctx, struct passwd **out, char const *name))
	Resolve a username to a passwd entry. More...
int	fr_perm_getpwuid (TALLOC_CTX *ctx, struct passwd **out, uid_t uid))
	Resolve a uid to a passwd entry. More...
int	fr_perm_gid_from_str (TALLOC_CTX *ctx, gid_t *out, char const *name))
	Resolve a group name to a GID. More...
char *	fr_perm_gid_to_str (TALLOC_CTX *ctx, gid_t gid)
char const *	fr_perm_mode_to_oct (char out[static 5], mode_t mode)
char const *	fr_perm_mode_to_str (char out[static 10], mode_t mode)
	Convert mode_t into humanly readable permissions flags. More...
int	fr_perm_uid_from_str (TALLOC_CTX *ctx, uid_t *out, char const *name))
	Resolve a user name to a GID. More...
char *	fr_perm_uid_to_str (TALLOC_CTX *ctx, uid_t uid)
	Print uid to a string. More...

Detailed Description

Functions to produce and parse the FreeRADIUS presentation format.

Copyright

2021 Arran Cudbard-Bell (a.cud.nosp@m.bard.nosp@m.b@fre.nosp@m.erad.nosp@m.ius.o.nosp@m.rg)

Definition in file perm.h.

Function Documentation

fr_perm_file_error()

void fr_perm_file_error

(

int

num

)

Write a file access error to the fr_strerror buffer, including euid/egid.

Note

retrieve error with fr_strerror()

Parameters

num	Usually errno, unless the error is returned by the function.

Definition at line 403 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_getgrgid()

int fr_perm_getgrgid	(	TALLOC_CTX *	ctx,
		struct group **	out,
		gid_t	gid
	)

Resolve a gid to a group database entry.

Resolves a gid to a group database entry. The memory to hold the group entry is talloced under ctx, and must be freed when no longer required.

Parameters

ctx	to allocate passwd entry in.
out	Where to write pointer to entry.
gid	to resolve.

Returns

• 0 on success.
• -1 on failure.

Definition at line 201 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_getgrnam()

int fr_perm_getgrnam	(	TALLOC_CTX *	ctx,
		struct group **	out,
		char const *	name
	)

Resolve a group name to a group database entry.

Resolves a group name to a group database entry. The memory to hold the group entry is talloced under ctx, and must be freed when no longer required.

Parameters

ctx	to allocate passwd entry in.
out	Where to write pointer to entry.
name	to resolve.

Returns

• 0 on success.
• -1 on failure.

Definition at line 264 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_getpwnam()

int fr_perm_getpwnam	(	TALLOC_CTX *	ctx,
		struct passwd **	out,
		char const *	name
	)

Resolve a username to a passwd entry.

Resolves a username to a passwd entry. The memory to hold the passwd entry is talloced under ctx, and must be freed when no longer required.

Parameters

ctx	to allocate passwd entry in.
out	Where to write pointer to entry.
name	to resolve.

Returns

• 0 on success.
• -1 on failure.

Definition at line 138 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_getpwuid()

int fr_perm_getpwuid	(	TALLOC_CTX *	ctx,
		struct passwd **	out,
		uid_t	uid
	)

Resolve a uid to a passwd entry.

Resolves a uid to a passwd entry. The memory to hold the passwd entry is talloced under ctx, and must be freed when no longer required.

Parameters

ctx	to allocate passwd entry in.
out	Where to write pointer to entry.
uid	to resolve.

Returns

• 0 on success.
• -1 on failure.

Definition at line 75 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_gid_from_str()

int fr_perm_gid_from_str	(	TALLOC_CTX *	ctx,
		gid_t *	out,
		char const *	name
	)

Resolve a group name to a GID.

Parameters

[in]	ctx	TALLOC_CTX for temporary allocations.
[in]	out	where to write gid.
[in]	name	of group.

Returns

• 0 on success.
• -1 on failure.

Definition at line 345 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_gid_to_str()

char* fr_perm_gid_to_str	(	TALLOC_CTX *	ctx,
		gid_t	gid
	)

fr_perm_mode_to_oct()

char const* fr_perm_mode_to_oct	(	char	out[static 5],
		mode_t	mode
	)

Definition at line 51 of file perm.c.

Here is the caller graph for this function:

fr_perm_mode_to_str()

char const* fr_perm_mode_to_str	(	char	out[static 10],
		mode_t	mode
	)

Convert mode_t into humanly readable permissions flags.

Author

Jonathan Leffler.

Parameters

mode	to convert.
out	Where to write the string to, must be exactly 10 bytes long.

Definition at line 36 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_uid_from_str()

int fr_perm_uid_from_str	(	TALLOC_CTX *	ctx,
		uid_t *	out,
		char const *	name
	)

Resolve a user name to a GID.

Parameters

[in]	ctx	TALLOC_CTX for temporary allocations.
[in]	out	where to write gid.
[in]	name	of user.

Returns

• 0 on success.
• -1 on failure.

Definition at line 323 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_perm_uid_to_str()

char* fr_perm_uid_to_str	(	TALLOC_CTX *	ctx,
		uid_t	uid
	)

Print uid to a string.

Parameters

ctx	TALLOC_CTX for temporary allocations.
uid	to resolve.

Returns

• 0 on success.
• -1 on failure.

Definition at line 366 of file perm.c.

Here is the call graph for this function:

Here is the caller graph for this function: