개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

ct_tmpl_clear(3contract)

Contract Management Library Functions
                                                   ct_tmpl_activate(3CONTRACT)



NAME
       ct_tmpl_activate,  ct_tmpl_clear,  ct_tmpl_create,  ct_tmpl_set_cookie,
       ct_tmpl_set_critical,   ct_tmpl_set_informative,    ct_tmpl_get_cookie,
       ct_tmpl_get_critical,  ct_tmpl_get_informative  -  common contract tem‐
       plate functions

SYNOPSIS
       cc [ flag... ] file... -D_LARGEFILE64_SOURCE -lcontract [ library... ]
       #include <libcontract.h>

       int ct_tmpl_activate(int fd);


       int ct_tmpl_clear(int fd);


       int ct_tmpl_create(int fd, ctid_t *idp);


       int ct_tmpl_set_cookie(int fd, uint64_t cookie);


       int ct_tmpl_set_critical(int fd, uint_t events);


       int ct_tmpl_set_informative(int fd, uint_t events);


       int ct_tmpl_get_cookie(int fd, uint64_t *cookiep);


       int ct_tmpl_get_critical(int fd, uint_t *eventsp);


       int ct_tmpl_get_informative(int fd, uint_t *eventsp);

DESCRIPTION
       These functions operate on contract template file descriptors  obtained
       from the contract(5) file system.


       The  ct_tmpl_activate()  function  makes the template referenced by the
       file descriptor fd the active template for the calling thread.


       The ct_tmpl_clear() function clears calling thread's active template.


       The ct_tmpl_create() function uses the template referenced by the  file
       descriptor  fd  to  create a new contract. If successful, the ID of the
       newly created contract is placed in *idp.


       The ct_tmpl_set_cookie() and ct_tmpl_get_cookie() functions  write  and
       read the cookie term of a contract template. The cookie term is ignored
       by the system, except to include its value in  a  resulting  contract's
       status object. The default cookie term is 0.


       The  ct_tmpl_set_critical()  and ct_tmpl_get_critical() functions write
       and read the critical event set term. The value is a collection of bits
       as described in the contract type's manual page.


       The  ct_tmpl_set_informative()  and ct_tmpl_get_informative() functions
       write and read the informative event set term. The value is  a  collec‐
       tion of bits as described in the contract type's manual page.

RETURN VALUES
       Upon   successful   completion,  ct_tmpl_activate(),  ct_tmpl_create(),
       ct_tmpl_set_cookie(),   ct_tmpl_get_cookie(),   ct_tmpl_set_critical(),
       ct_tmpl_get_critical(),          ct_tmpl_set_informative(),         and
       ct_tmpl_get_informative() return 0. Otherwise, they return  a  non-zero
       error value.

ERRORS
       The ct_tmpl_create() function will fail if:

       ERANGE    The  terms  specified in the template were unsatisfied at the
                 time of the call.


       EAGAIN    The project.max-contracts resource control  would  have  been
                 exceeded.



       The ct_tmpl_set_critical() and ct_tmpl_set_informative() functions will
       fail if:

       EINVAL    An invalid event was specified.



       The ct_tmpl_set_critical() function will fail if:

       EPERM    One of the specified events was disallowed  given  other  con‐
                tract  terms  (see  contract(5)) and {PRIV_CONTRACT_EVENT} was
                not in the effective set for the calling process.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSafe


SEE ALSO
       libcontract(3LIB), contract(5), attributes(7), lfcompile(7)



Oracle Solaris 11.4               1 Apr 2004
                                                   ct_tmpl_activate(3CONTRACT)