diff options
Diffstat (limited to 'usr/src/man/man3scf/scf_service_create.3scf')
| -rw-r--r-- | usr/src/man/man3scf/scf_service_create.3scf | 54 |
1 files changed, 8 insertions, 46 deletions
diff --git a/usr/src/man/man3scf/scf_service_create.3scf b/usr/src/man/man3scf/scf_service_create.3scf index ea84428464..9776694f76 100644 --- a/usr/src/man/man3scf/scf_service_create.3scf +++ b/usr/src/man/man3scf/scf_service_create.3scf @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH scf_service_create 3SCF "27 Aug 2007" "SunOS 5.11" "Service Configuration Facility Library Functions" +.TH SCF_SERVICE_CREATE 3SCF "Aug 27, 2007" .SH NAME scf_service_create, scf_service_handle, scf_service_destroy, scf_service_get_parent, scf_service_get_name, scf_scope_get_service, @@ -12,7 +12,7 @@ handles and services in the Service Configuration Facility .SH SYNOPSIS .LP .nf -cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lscf\fR [ \fIlibrary\fR\&.\|.\|. ] +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lscf\fR [ \fIlibrary\fR\&.\|.\|. ] #include <libscf.h> \fBscf_service_t *\fR\fBscf_service_create\fR(\fBscf_handle_t *\fR\fIhandle\fR); @@ -64,12 +64,10 @@ tree. Services are children of a scope (see \fBscf_scope_create\fR(3SCF)) and have three sets of children: .sp .ne 2 -.mk .na \fBProperty groups\fR .ad .RS 19n -.rt These hold configuration information shared by all of the instances of the service. See \fBscf_pg_create\fR(3SCF), \fBscf_iter_service_pgs\fR(3SCF), and \fBscf_iter_service_pgs_typed\fR(3SCF). @@ -77,12 +75,10 @@ service. See \fBscf_pg_create\fR(3SCF), \fBscf_iter_service_pgs\fR(3SCF), and .sp .ne 2 -.mk .na \fBInstances\fR .ad .RS 19n -.rt A particular instantiation of the service. See \fBscf_instance_create\fR(3SCF). .RE @@ -145,34 +141,28 @@ Upon successful completion, \fBscf_service_get_parent()\fR, The \fBscf_service_create()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_INVALID_ARGUMENT\fR\fR .ad .RS 30n -.rt The value of the \fIhandle\fR argument is \fINULL\fR. .RE .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NO_MEMORY\fR\fR .ad .RS 30n -.rt There is not enough memory to allocate an \fBscf_service_t\fR. .RE .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NO_RESOURCES\fR\fR .ad .RS 30n -.rt The server does not have adequate resources for a new scope handle. .RE @@ -181,12 +171,10 @@ The server does not have adequate resources for a new scope handle. The \fBscf_service_handle()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_HANDLE_DESTROYED\fR\fR .ad .RS 30n -.rt The handle associated with \fIsvc\fR has been destroyed. .RE @@ -196,7 +184,6 @@ The \fBscf_service_get_name()\fR, \fBscf_service_get_parent()\fR, and \fBscf_service_delete()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_DELETED\fR\fR .ad @@ -207,7 +194,6 @@ The service has been deleted by someone else. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NOT_SET\fR\fR .ad @@ -218,7 +204,6 @@ The service is not set. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NOT_BOUND\fR\fR .ad @@ -229,7 +214,6 @@ The handle is not bound. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_CONNECTION_BROKEN\fR\fR .ad @@ -243,23 +227,19 @@ The connection to the repository was lost. The \fBscf_service_delete()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_EXISTS\fR\fR .ad .RS 26n -.rt The service contains instances. .RE .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NO_RESOURCES\fR\fR .ad .RS 26n -.rt The server does not have adequate resources for a new scope handle. .RE @@ -268,12 +248,10 @@ The server does not have adequate resources for a new scope handle. The \fBscf_scope_add_service()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_EXISTS\fR\fR .ad .RS 20n -.rt A {service,instance,property group} named \fIname\fR already exists. .RE @@ -282,24 +260,20 @@ A {service,instance,property group} named \fIname\fR already exists. The \fBscf_scope_get_service()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_BACKEND_ACCESS\fR\fR .ad .RS 28n -.rt The storage mechanism that the repository server (\fBsvc.configd\fR(1M)) chose for the operation denied access. .RE .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_INTERNAL\fR\fR .ad .RS 28n -.rt An internal error occurred. .RE @@ -309,7 +283,6 @@ The \fBscf_scope_add_service()\fR and \fBscf_scope_get_service()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_CONNECTION_BROKEN\fR\fR .ad @@ -320,7 +293,6 @@ The connection to the repository was lost. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_DELETED\fR\fR .ad @@ -331,7 +303,6 @@ The parent entity has been deleted. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_HANDLE_MISMATCH\fR\fR .ad @@ -342,7 +313,6 @@ The scope and service are not derived from the same handle. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_INVALID_ARGUMENT\fR\fR .ad @@ -353,7 +323,6 @@ The value of the \fIname\fR argument is not a valid service name. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NO_RESOURCES\fR\fR .ad @@ -364,7 +333,6 @@ The server does not have the resources to complete the request. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NOT_BOUND\fR\fR .ad @@ -375,7 +343,6 @@ The handle is not bound. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NOT_FOUND\fR\fR .ad @@ -386,7 +353,6 @@ The service specified by \fIname\fR was not found. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_NOT_SET\fR\fR .ad @@ -401,7 +367,6 @@ The \fBscf_scope_add_service()\fR and \fBscf_service_delete()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_PERMISSION_DENIED\fR\fR .ad @@ -412,7 +377,6 @@ The user does not have sufficient privileges to create or delete a service. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_BACKEND_READONLY\fR\fR .ad @@ -423,7 +387,6 @@ The repository backend is read-only. .sp .ne 2 -.mk .na \fB\fBSCF_ERROR_BACKEND_ACCESS\fR\fR .ad @@ -443,15 +406,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO |