Manual Pages for UNIX Operating System command usage for man scf_tmpl_pg_common_name

Service Configuration Facility Library Functions
                                           scf_tmpl_pg_name(3SCF)



NAME
     scf_tmpl_pg_name,   scf_tmpl_pg_type,    scf_tmpl_pg_target,
     scf_tmpl_pg_required,               scf_tmpl_pg_common_name,
     scf_tmpl_pg_description -  retrieve  the  metadata  about  a
     specific property group

SYNOPSIS
     cc [ flag... ] file... -lscf [ library... ]
     #include 

     ssize_t scf_tmpl_pg_name(const scf_pg_tmpl_t *pg_tmpl,
          char **out);


     ssize_t scf_tmpl_pg_type(const scf_pg_tmpl_t *pg_tmpl,
          char **out);


     ssize_t scf_tmpl_pg_target(const scf_pg_tmpl_t *pg_tmpl,
          char **out);


     int scf_tmpl_pg_required(const scf_pg_tmpl_t *pg_tmpl,
          uint8_t *out)


     ssize_t scf_tmpl_pg_common_name(const scf_pg_tmpl_t *pg_tmpl,
          char * locale, char **out);


     ssize_t scf_tmpl_pg_description(const scf_pg_tmpl_t *pg_tmpl,
          char * locale, char **out);


DESCRIPTION
     These functions retrieve the metadata about a specific  pro-
     perty group. They require that the template for the property
     group   has   already   been   located   by   one   of   the
     scf_tmpl_pg_create(3SCF) suite of functions.


     The scf_tmpl_pg_name() function retrieves the  name  of  the
     property  group  template  and place it in *out. If the pro-
     perty   group   name   is   implicitly    wildcarded    (see
     smf_template(5))  in the template, this function will return
     a string containing SCF_TMPL_WILDCARD  ("*")  in  *out.  The
     caller  is  responsible  for freeing the *out buffer on suc-
     cess.






SunOS 5.11          Last change: 28 Oct 2008                    1






Service Configuration Facility Library Functions
                                           scf_tmpl_pg_name(3SCF)



     The scf_tmpl_pg_type() function will retrieve  the  type  of
     the  property  group  template  and place it in *out. If the
     property  group   type   is   implicitly   wildcarded   (see
     smf_template(5))  in the template, this function will return
     a string containing SCF_TMPL_WILDCARD  ("*")  in  *out.  The
     caller  is  responsible  for freeing the *out buffer on suc-
     cess.


     The scf_tmpl_pg_target() function will retrieve  the  target
     of  the  property  group  template and place it in *out. The
     caller is responsible for freeing the *out  buffer  on  suc-
     cess.


     The scf_tmpl_pg_required() function will  determine  whether
     the  property group is required and place the result of that
     check in *out. If required is unset, out will be the default
     value  of  0. If the property is explicitly set to required,
     out will be 1.


     The scf_tmpl_pg_common_name()  function  will  retrieve  the
     property  group's  localized  common  name as currently tem-
     plated and place it in  *out.  A  locale  (as  described  in
     setlocale(3C))  may  be specified, or if the supplied locale
     is NULL, the current locale will be used.  If a  common_name
     in the specified locale is not found, the function will also
     look for a common_name in the C locale. Some templates  will
     not  specify  the property group common name.  The caller is
     responsible for freeing the *out buffer on success.


     The scf_tmpl_pg_description()  function  will  retrieve  the
     property  group's  localized  description  as currently tem-
     plated and place it in  *out.  A  locale  (as  described  in
     setlocale(3C))  may  be specified, or if the supplied locale
     is NULL, the current locale will be used. If  a  description
     in the specified locale is not found, the function will also
     look for a description in the C locale. Some templates  will
     not  specify  the property group description.  The caller is
     responsible for freeing the *out buffer on success.

RETURN VALUES
     Upon     successful     completion,      scf_tmpl_pg_name(),
     scf_tmpl_pg_common_name(),        scf_tmpl_pg_description(),
     scf_tmpl_pg_target(),  and  scf_tmpl_pg_type()  return   the
     length  of the string written, not including the terminating
     null byte. Otherwise, they return -1.





SunOS 5.11          Last change: 28 Oct 2008                    2






Service Configuration Facility Library Functions
                                           scf_tmpl_pg_name(3SCF)



     Upon successful completion,  scf_tmpl_pg_required()  returns
     0. Otherwise, it returns -1.

ERRORS
     The      scf_tmpl_pg_name(),      scf_tmpl_pg_common_name(),
     scf_tmpl_pg_description(),           scf_tmpl_pg_required(),
     scf_tmpl_pg_target(), and scf_tmpl_pg_type() functions  will
     fail if:

     SCF_ERROR_BACKEND_ACCESS

         The  storage  mechanism  that  the   repository   server
         (svc.configd(1M)) chose for the operation denied access.


     SCF_ERROR_CONNECTION_BROKEN

         The connection to the repository was lost.


     SCF_ERROR_DELETED

         The template property group has been deleted.


     SCF_ERROR_HANDLE_DESTROYED

         The handle passed in has been destroyed.


     SCF_ERROR_INTERNAL

         An internal error occurred.


     SCF_ERROR_NO_MEMORY

         There   is   not   enough   memory   to   populate   the
         scf_pg_tmpl_t.


     SCF_ERROR_NO_RESOURCES

         The server does not have adequate resources to  complete
         the request.


     SCF_ERROR_NOT_BOUND

         The handle is not currently bound.




SunOS 5.11          Last change: 28 Oct 2008                    3






Service Configuration Facility Library Functions
                                           scf_tmpl_pg_name(3SCF)



     SCF_ERROR_PERMISSION_DENIED

         The template could not be read due  to  access  restric-
         tions.


     SCF_ERROR_TEMPLATE_INVALID

         The template data is invalid.



     The scf_tmpl_pg_common_name() and  scf_tmpl_pg_description()
     functions will fail if:

     SCF_ERROR_NOT_FOUND           The property does not exist or
                                   exists and has no value.


     SCF_ERROR_INVALID_ARGUMENT    The locale string is too long.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     svc.configd(1M),  scf_tmpl_pg_create(3SCF),   setlocale(3C),
     attributes(5), smf_template(5)














SunOS 5.11          Last change: 28 Oct 2008                    4






Service Configuration Facility Library Functions
                                           scf_tmpl_pg_name(3SCF)






















































SunOS 5.11          Last change: 28 Oct 2008                    5