Main Page   Modules   Data Structures   File List   Data Fields   Globals   Related Pages  

lcmaps_utils.h File Reference

API for the utilities for the LCMAPS. More...

#include <gssapi.h>
#include "lcmaps_types.h"
#include <grp.h>

Go to the source code of this file.

CREDENTIAL FUNCTIONS

char * lcmaps_get_dn (lcmaps_cred_id_t lcmaps_credential)
 Retrieve user DN from (LCMAPS) credential. More...


FILENAME FUNCTIONS

char * lcmaps_genfilename (char *prefix, char *path, char *suffix)
 Generate an absolute file name. More...

char * lcmaps_getfexist (int n,...)
 Picks the first existing file in argument list. More...

char * lcmaps_findfile (char *name)
 Checks for file in standard directories. More...


Functions

int lcmaps_get_gidlist (const char *username, int *ngroups, gid_t **group_list)
 Finds the list of gids for user in the group file (/etc/group). More...


Detailed Description

API for the utilities for the LCMAPS.

Author:
Martijn Steenbakkers for the EU DataGrid.
This header contains the declarations of the LCMAPS utility functions:
  1. lcmaps_get_dn():
  2. lcmaps_genfilename():
  3. lcmaps_getfexist():
  4. lcmaps_findfile():
  5. lcmaps_findfile():
  6. lcmaps_get_gidlist():

Definition in file lcmaps_utils.h.


Function Documentation

lcmaps_findfile char *    name
 

Checks for file in standard directories.

The directories that are checked are:

  • current directory
  • "modules"
  • LCMAPS_ETC_HOME
  • LCMAPS_MOD_HOME
  • LCMAPS_LIB_HOME
Parameters:
name  string containing the file name
Returns:
pointer to a string containing the absolute path to the file, which has to be freed or NULL.

Definition at line 391 of file lcmaps_utils.c.

lcmaps_genfilename char *    prefix,
char *    path,
char *    suffix
 

Generate an absolute file name.

Given a starting prefix, a relative or absolute path, and a suffix an absolute file name is generated. Uses the prefix only if the path is relative. (Copied (and modified) from GLOBUS gatekeeper.c)

Parameters:
prefix  string containing the prefix to be prepended.
path  relative/absolute path to file name.
suffix  string containing the suffix to be appended.
Returns:
pointer to a string containing the absolute path to the file, which has to be freed.

Definition at line 249 of file lcmaps_utils.c.

lcmaps_get_dn lcmaps_cred_id_t    lcmaps_credential
 

Retrieve user DN from (LCMAPS) credential.

This function takes an LCMAPS credential as input and returns the corresponding user distinguished name (DN).

(Internal:) If the GLOBUS credential part of the LCMAPS credential is empty the user DN is already included in the LCMAPS credential.

Parameters:
lcmaps_credential  the LCMAPS credential
Returns:
a string containing the user DN

Definition at line 153 of file lcmaps_utils.c.

lcmaps_get_gidlist const char *    username,
int *    ngroups,
gid_t **    group_list
 

Finds the list of gids for user in the group file (/etc/group).

Returns a list of gid_t which should be freed by calling program.

Parameters:
username  the name of the user
ngroups  ptr to int which will be filled with the number of gids
group_list  ptr to an array of gid_t
Return values:
0  success
-1  realloc failure
-2  getgrent failure
1  failure

Definition at line 579 of file lcmaps_utils.c.

lcmaps_getfexist int    n,
...   
 

Picks the first existing file in argument list.

Parameters:
n  the number of paths presented in the following argument list.
...  variable argument list of paths.
Returns:
filename found or NULL

Definition at line 349 of file lcmaps_utils.c.


Generated on Sat Oct 2 02:18:27 2004 for edg-lcmaps by doxygen1.2.14 written by Dimitri van Heesch, © 1997-2002