commit 7fc1e1beb447420f3508e85c9cac902a438dc49a Author: Jaromir Hradilek jhradile@redhat.com Date: Wed Jun 16 16:01:00 2010 +0200
Updated the ntsysv section.
en-US/Controlling_Access_to_Services.xml | 112 +++++++++++++++----- .../controlling-access-to-services-ntsysv.png | Bin 0 -> 110269 bytes en-US/images/ntsysv.png | Bin 15885 -> 0 bytes 3 files changed, 84 insertions(+), 28 deletions(-) --- diff --git a/en-US/Controlling_Access_to_Services.xml b/en-US/Controlling_Access_to_Services.xml index 253a546..a38edea 100644 --- a/en-US/Controlling_Access_to_Services.xml +++ b/en-US/Controlling_Access_to_Services.xml @@ -142,14 +142,14 @@ Password:</screen> </para> <figure id="fig-services-serviceconf"> <title> - <application>Service Configuration </application> Utility + <application>The Service Configuration </application> Utility </title> <mediaobject> <imageobject> <imagedata fileref="images/controlling-access-to-services-service_configuration.png" format="PNG" scalefit="1" /> </imageobject> <textobject> - <para>Service Configuration Utility</para> + <para>The Service Configuration Utility</para> </textobject> </mediaobject> </figure> @@ -327,6 +327,88 @@ Password:</screen> </para> </section> </section> + <section id="s2-services-ntsysv"> + <title>Using the <application>ntsysv</application> Utility</title> + <para> + The <application>ntsysv</application> utility is a command line application with a simple text user interface to configure which services are to be started in selected runlevels. Note that in order to use the utility, you must obtain superuser privileges first: + </para> + <screen>~]$ <command>su -</command> +Password: </screen> + <para> + To start the utility, type the following command: + </para> + <screen>~]# <command>ntsysv</command></screen> + <figure float="0" id="fig-ntsysv"> + <title>The <application>ntsysv</application> utility</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/controlling-access-to-services-ntsysv.png" format="PNG"/> + </imageobject> + <textobject> + <para>The <application>ntsysv</application> utility</para> + </textobject> + </mediaobject> + </figure> + <para> + The utility displays the list of available services (i.e., the services from the <filename class="directory">/etc/rc.d/init.d/</filename> directory) along with their current status and a description obtainable by pressing <keycap>F1</keycap>. See <xref linkend="tab-services-ntsysv-states" /> for a list of used symbols and an explanation of their meaning. + </para> + <table id="tab-services-ntsysv-states"> + <title>Possible Service States</title> + <tgroup cols="2"> + <colspec colname="symbol" colnum="1" colwidth="10*" /> + <colspec colname="description" colnum="2" colwidth="60*" /> + <thead> + <row> + <entry>Symbol</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <guilabel>[*]</guilabel> + </entry> + <entry> + The service is enabled. + </entry> + </row> + <row> + <entry> + <guilabel>[ ]</guilabel> + </entry> + <entry> + The service is disabled. + </entry> + </row> + </tbody> + </tgroup> + </table> + <section id="s3-services-ntsysv-enabling"> + <title>Enabling the Service</title> + <para> + To enable a service, navigate through the list using the <keycap>Up</keycap> and <keycap>Down</keycap> arrows keys, and select it with the <keycap>Spacebar</keycap>. An asterisk (<guilabel>*</guilabel>) should appear in the brackets. Once you are done, use <keycap>Tab</keycap> to navigate to the <guibutton>Ok</guibutton> button, and confirm the changes by pressing <keycap>Enter</keycap>. + </para> + <para> + Please, keep in mind that <application>ntsysv</application> does not actually run the service. If you need to start the service immediately, use the <command>service <replaceable><service></replaceable> start</command> command. + </para> + </section> + <section id="s3-services-ntsysv-disabling"> + <title>Disabling the Service</title> + <para> + To disable a service, navigate through the list using the <keycap>Up</keycap> and <keycap>Down</keycap> arrows keys, and toggle its status with the <keycap>Spacebar</keycap>. An asterisk (<guilabel>*</guilabel>) in the brackets should disappear. Once you are done, use <keycap>Tab</keycap> to navigate to the <guibutton>Ok</guibutton> button, and confirm the changes by pressing <keycap>Enter</keycap>. + </para> + <para> + Please, keep in mind that <application>ntsysv</application> does not actually stop the service. If you need to stop the service immediately, use the <command>service <replaceable><service></replaceable> stop</command> command. + </para> + </section> + <section id="s3-services-ntsysv-selecting"> + <title>Selecting the Runlevels</title> + <para> + By default, the <application>ntsysv</application> utility affects the current runlevel only. To enable or disable services for other runlevels, run the command with the additional <option>--level</option> option followed by the string of numbers from 0 to 6 representing each runlevel you want to configure. For example, to configure runlevels 3 and 5, type: + </para> + <screen>~]# <command>ntsysv --level 35</command></screen> + </section> + </section> <section id="s2-services-chkconfig"> <title>Using the <command>chkconfig</command> Utility</title> <para> @@ -406,32 +488,6 @@ rsync off</screen> </para> </section> </section> - <section id="s2-services-ntsysv"> - <title>Using the <application>ntsysv</application> Utility</title> - <para>The <application>ntsysv</application> utility provides a simple interface for activating or deactivating services. You can use <application>ntsysv</application> to turn an <command>xinetd</command>-managed service on or off. You can also use <application>ntsysv</application> to configure runlevels. By default, only the current runlevel is configured. To configure a different runlevel, specify one or more runlevels with the <option>--level</option> option. For example, the command <command>ntsysv --level 345</command> configures runlevels 3, 4, and 5.</para> - <para>The <application>ntsysv</application> interface works like the text mode installation program. Use the up and down arrows to navigate up and down the list. The space bar selects/unselects services and is also used to "press" the <guilabel>Ok</guilabel> and <guilabel>Cancel</guilabel> buttons. To move between the list of services and the <guilabel>Ok</guilabel> and <guilabel>Cancel</guilabel> buttons, use the <keycap>Tab</keycap> key. An asterisk (<guilabel>*</guilabel>) signifies that a service is set to on. Pressing the <keycap>F1</keycap> key displays a short description of the selected service.</para> - <!-- RHEL5: ddomingo@redhat.com: added PNG image --> - <figure - float="0" - id="fig-ntsysv"> - <title>The <application>ntsysv</application> utility</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/ntsysv.png" - format="PNG"/> - </imageobject> - <textobject> - <para>The <application>ntsysv</application> utility</para> - </textobject> - </mediaobject> - </figure> - <warning> - <title>Warning</title> - <para>Services managed by <command>xinetd</command> are immediately affected by <application>ntsysv</application>. For all other services, changes do not take effect immediately. You must stop or start the individual service with the command <command>service <replaceable><daemon></replaceable> stop</command> (where <replaceable><daemon></replaceable> is the name of the service you want to stop; for example, <command>httpd</command>). Replace <command>stop</command> with <command>start</command> or <command>restart</command> to start or restart the service.</para> - </warning> - </section> - </section> <section id="s1-services-tcp-wrappers"> <title>Configuring TCP Wrappers</title> diff --git a/en-US/images/controlling-access-to-services-ntsysv.png b/en-US/images/controlling-access-to-services-ntsysv.png new file mode 100644 index 0000000..70bc146 Binary files /dev/null and b/en-US/images/controlling-access-to-services-ntsysv.png differ
docs-commits@lists.fedoraproject.org