xref: /onnv-gate/usr/src/cmd/svc/svccfg/svccfg_help.c (revision 5841:88e6ac19e43e)
10Sstevel@tonic-gate /*
20Sstevel@tonic-gate  * CDDL HEADER START
30Sstevel@tonic-gate  *
40Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
55040Swesolows  * Common Development and Distribution License (the "License").
65040Swesolows  * You may not use this file except in compliance with the License.
70Sstevel@tonic-gate  *
80Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
90Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
100Sstevel@tonic-gate  * See the License for the specific language governing permissions
110Sstevel@tonic-gate  * and limitations under the License.
120Sstevel@tonic-gate  *
130Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
140Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
150Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
160Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
170Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
180Sstevel@tonic-gate  *
190Sstevel@tonic-gate  * CDDL HEADER END
200Sstevel@tonic-gate  */
215040Swesolows 
220Sstevel@tonic-gate /*
23*5841Samaguire  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
240Sstevel@tonic-gate  * Use is subject to license terms.
250Sstevel@tonic-gate  */
260Sstevel@tonic-gate 
270Sstevel@tonic-gate #pragma ident	"%Z%%M%	%I%	%E% SMI"
280Sstevel@tonic-gate 
290Sstevel@tonic-gate #include "svccfg.h"
300Sstevel@tonic-gate #include "svccfg_grammar.h"
310Sstevel@tonic-gate 
320Sstevel@tonic-gate struct help_message help_messages[] = {
330Sstevel@tonic-gate 	{ SCC_VALIDATE, "validate file\n\n"
340Sstevel@tonic-gate 		"Process a manifest file without changing the repository."
350Sstevel@tonic-gate 	},
360Sstevel@tonic-gate 	{ SCC_IMPORT, "import file\n\nImport a manifest into the repository." },
375040Swesolows 	{ SCC_EXPORT, "export [-a] {service | pattern} [> file]\n\n"
380Sstevel@tonic-gate "Print a manifest for service to file, or standard output if not specified."
390Sstevel@tonic-gate 	},
405040Swesolows 	{ SCC_ARCHIVE, "archive [-a] [> file]\n\n"
410Sstevel@tonic-gate "Print an archive to file, or standard output if not specified."
420Sstevel@tonic-gate 	},
435040Swesolows 	{ SCC_RESTORE, "restore file\n\n"
445040Swesolows "Restore the contents of a previously-generated archive."
455040Swesolows 	},
460Sstevel@tonic-gate 	{ SCC_APPLY, "apply file\n\nApply a profile." },
470Sstevel@tonic-gate 	{ SCC_EXTRACT, "extract [> file]\n\n"
480Sstevel@tonic-gate "Print a profile to file, or standard output if not specified." },
490Sstevel@tonic-gate 	{ SCC_REPOSITORY, "repository file\n\nSet the repository to modify." },
500Sstevel@tonic-gate 	{ SCC_INVENTORY, "inventory file\n\n"
510Sstevel@tonic-gate 		"Print the services and instances contained in a manifest."
520Sstevel@tonic-gate 	},
530Sstevel@tonic-gate 	{ SCC_SET, "set [-vV]\n\n"
540Sstevel@tonic-gate "Without arguments, display current options.  Otherwise set the given options."
550Sstevel@tonic-gate 	},
560Sstevel@tonic-gate 	{ SCC_END, "end\n\nStop processing and exit." },
570Sstevel@tonic-gate 	{ SCC_HELP, "help [command]\n\nDisplay help." },
580Sstevel@tonic-gate 	{ SCC_LIST, "list [glob_pattern]\n\n"
590Sstevel@tonic-gate 		"List children of the currently selected entity."
600Sstevel@tonic-gate 	},
610Sstevel@tonic-gate 	{ SCC_ADD, "add name\n\n"
620Sstevel@tonic-gate 		"Add a new child entity to the currently selected entity."
630Sstevel@tonic-gate 	},
640Sstevel@tonic-gate 	{ SCC_DELETE, "delete [-f] {name | fmri | pattern}\n\n"
650Sstevel@tonic-gate "Delete the named child entity or the one indicated by fmri.  With -f, delete\n"
660Sstevel@tonic-gate "running services.\n"
670Sstevel@tonic-gate 	},
680Sstevel@tonic-gate 	{ SCC_SELECT, "select {name | fmri | pattern}\n\n"
690Sstevel@tonic-gate 		"Select the named child entity or the one indicated by fmri."
700Sstevel@tonic-gate 	},
710Sstevel@tonic-gate 	{ SCC_UNSELECT, "unselect\n\n"
720Sstevel@tonic-gate 		"Select the parent of the currently selected entity."
730Sstevel@tonic-gate 	},
740Sstevel@tonic-gate 	{ SCC_LISTPG, "listpg [glob_pattern]\n\n"
750Sstevel@tonic-gate 		"List property groups of the currently selected entity."
760Sstevel@tonic-gate 	},
770Sstevel@tonic-gate 	{ SCC_ADDPG, "addpg name type [P]\n\n"
780Sstevel@tonic-gate 		"Add a new property group to the currently selected entity."
790Sstevel@tonic-gate 	},
800Sstevel@tonic-gate 	{ SCC_DELPG, "delpg name\n\n"
810Sstevel@tonic-gate "Delete the named property group from the currently selected entity."
820Sstevel@tonic-gate 	},
830Sstevel@tonic-gate 	{ SCC_LISTPROP, "listprop [glob_pattern]\n\n"
840Sstevel@tonic-gate "List property groups and properties of the currently selected entity."
850Sstevel@tonic-gate 	},
860Sstevel@tonic-gate 	{ SCC_SETPROP,
870Sstevel@tonic-gate 		"\tsetprop pg/name = [type:] value\n"
880Sstevel@tonic-gate 		"\tsetprop pg/name = [type:] ([value...])\n\n"
890Sstevel@tonic-gate "Set the pg/name property of the currently selected entity.  Values may be\n"
900Sstevel@tonic-gate "enclosed in double-quotes.  Value lists may span multiple lines."
910Sstevel@tonic-gate 	},
920Sstevel@tonic-gate 	{ SCC_DELPROP, "delprop pg/name\n\n"
930Sstevel@tonic-gate 		"Delete the pg/name property of the currently selected entity."
940Sstevel@tonic-gate 	},
950Sstevel@tonic-gate 	{ SCC_EDITPROP, "editprop\n\n"
960Sstevel@tonic-gate "Invoke $EDITOR to edit the properties of the currently selected entity."
970Sstevel@tonic-gate 	},
980Sstevel@tonic-gate 	{ SCC_ADDPROPVALUE, "addpropvalue pg/name [type:] value\n\n"
990Sstevel@tonic-gate "Add the given value to the named property."
1000Sstevel@tonic-gate 	},
1010Sstevel@tonic-gate 	{ SCC_DELPROPVALUE, "delpropvalue pg/name glob_pattern\n\n"
1020Sstevel@tonic-gate "Delete all values matching the glob pattern fron the given property."
1030Sstevel@tonic-gate 	},
1040Sstevel@tonic-gate 	{ SCC_SETENV, "setenv [-s | -i | -m method] NAME value\n\n"
1050Sstevel@tonic-gate "Set an environment variable for the given service, instance, or method "
1060Sstevel@tonic-gate "context."
1070Sstevel@tonic-gate 	},
1080Sstevel@tonic-gate 	{ SCC_UNSETENV, "unsetenv [-s | -i | -m method] NAME value\n\n"
1090Sstevel@tonic-gate "Unset an environment variable for the given service, instance, or method "
1100Sstevel@tonic-gate "context."
1110Sstevel@tonic-gate 	},
1120Sstevel@tonic-gate 	{ SCC_LISTSNAP, "listsnap\n\n"
1130Sstevel@tonic-gate 		"List snapshots of the currently selected instance."
1140Sstevel@tonic-gate 	},
1150Sstevel@tonic-gate 	{ SCC_SELECTSNAP, "selectsnap [snapshot]\n\n"
1160Sstevel@tonic-gate "Select a snapshot of the currently selected instance, or the Editing\n"
1170Sstevel@tonic-gate "snapshot by default."
1180Sstevel@tonic-gate 	},
1190Sstevel@tonic-gate 	{ SCC_REVERT, "revert [snapshot]\n\n"
1200Sstevel@tonic-gate "Change the properties of the currently selected instance and its ancestors\n"
1210Sstevel@tonic-gate "to those in a snapshot, or the currently selected snapshot by default."
1220Sstevel@tonic-gate 	},
123*5841Samaguire 	{ SCC_REFRESH, "refresh\n\n"
124*5841Samaguire "Commit the values from the current configuration to the running\n"
125*5841Samaguire "snapshot, making them available for use by the currently selected\n"
126*5841Samaguire "instance.  If the repository subcommand has not been used to select\n"
127*5841Samaguire "a repository, inform the instance's restarter to re-read the updated\n"
128*5841Samaguire "configuration."
129*5841Samaguire 	},
1300Sstevel@tonic-gate 	{ 0, NULL }
1310Sstevel@tonic-gate };
132