getprofnam

 

---

 
 
 
 Introduction to Library Functions             getprofattr(3SECDB)
 
 
 


NAME
      getprofattr,   getprofnam,    free_profattr,    setprofattr,
      endprofattr - get profile description and attributes
 


SYNOPSIS
      cc [ flag... ] file... -lsecdb  -lsocket  -lnsl  -lintl [ library... ]
      #include <prof.h>
 
      profattr_t *getprofattr(void);
 
      profattr_t *getprofnam(const char *name);
 
      void free_profattr(profattr_t *pd);
 
      void setprofattr(void);
 
      void endprofattr(void);
 


DESCRIPTION
      The getprofattr() and getprofnam() functions each  return  a
      prof_attr  entry.  Entries  can come from any of the sources
      specified in the nsswitch.conf(4) file.
 
      The getprofattr() function enumerates prof_attr entries. The
      getprofnam()  function searches for a prof_attr entry with a
      given name.  Successive  calls  to  these  functions  return
      either successive prof_attr entries or NULL.
 
      The internal  representation  of  a  prof_attr  entry  is  a
      profattr_t structure defined in  <prof_attr.h> with the fol-
      lowing members:
 
      char *name; /* Name of the profile */
      char *res1; /* Reserved for future use */
      char *res2; /* Reserved for future use */
      char *desc; /* Description/Purpose of the profile */
      kva_t     *attr; /* Profile attributes */
 
      The free_profattr() function releases  memory  allocated  by
      the getprofattr() and getprofnam() functions.
 
      The setprofattr() function "rewinds" to the beginning of the
      enumeration of prof_attr entries.  Calls to getprofnam() can
      leave the enumeration in an indeterminate state.  Therefore,
      setprofattr() should be called before the first call to get-
      profattr().
 
      The endprofattr() function may be called  to  indicate  that
      prof_attr  processing is complete; the system may then close
      any open prof_attr file, deallocate storage, and so forth.
 
 
 
 
 
 SunOS 5.8           Last change: 12 Aug 1999                    1
 
 
 
 
 
 
 Introduction to Library Functions             getprofattr(3SECDB)
 
 
 
 RETURN VALUES
      The  getprofattr()  function  returns   a   pointer   to   a
      profattr_t if it successfully enumerates an entry; otherwise
      it returns NULL, indicating the end of the enumeration.
 
      The getprofnam() function returns a pointer to a  profattr_t
      if it successfully locates the requested entry; otherwise it
      returns NULL.
 
 USAGE
      Individual attributes in the prof_attr structure   can  be
      referred to by calling the kva_match(3SECDB) function.
 
      Because the list of legal keys is likely to expand, any code
      must  be  written  to ignore unknown key-value pairs without
      error.
 
      The getprofattr() and getprofnam() functions  both  allocate
      memory  for  the pointers they return. This memory should be
      deallocated with the free_profatt() function.
 
      Applications that  use  the  interfaces  described  in  this
      manual  page  cannot be  linked statically, since the imple-
      mentations of these functions employ   dynamic  loading  and
      linking  of  shared  objects  at  run time.  Note that these
      interfaces are reentrant even though they do not use the  _r
      suffix naming convention.
 


FILES
      /etc/security/prof_attr
            profiles and their descriptions
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | MT-Level                    | MT-Safe                     |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      auths(1),         profiles(1),          getexecattr(3SECDB),
      getauthattr(3SECDB), prof_attr(4)
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 12 Aug 1999                    2
 
 
 

---