Bug 90749

Summary: There is no service manpage
Product: [Retired] Red Hat Linux Reporter: Edward J. Huff <ejhuff>
Component: initscriptsAssignee: Bill Nottingham <notting>
Status: CLOSED DUPLICATE QA Contact: Brock Organ <borgan>
Severity: medium Docs Contact:
Priority: medium    
Version: 7.3CC: djuran, rvokal
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2005-09-30 18:57:47 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Edward J. Huff 2003-05-13 11:57:37 UTC
From Bugzilla Helper:
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.0.1) Gecko/20021003

Description of problem:
initscripts package includes /sbin/service, but there is no
manpage for this script.


Version-Release number of selected component (if applicable):
initscripts-6.67-1

How reproducible:
Always

Steps to Reproduce:
1.man service
2.
3.
    

Actual Results:  No manual entry for service


Expected Results:  

NAME

service -- run an /etc/init.d script with clean environment

SYNOPSIS

/sbin/service --help | -h | --h | -V | --version 

/sbin/service --status-all

/sbin/service service_name [ command [ options... ] | --full-restart ]

DESCRIPTION

/sbin/service foo cmd

is about the same as running 

/etc/init.d/foo cmd

Or more precisely, it is the same as

cd /etc/init.d/
env -i LANG=$LANG /etc/init.d/foo cmd

which empties the environment except for the LANG variable and runs the 'foo'
script with working directory /etc/init.d/ and specified argument(s).

/sbin/service foo --full-restart

is the same as

cd /etc/init.d/
env -i LANG=$LANG /etc/init.d/foo stop
env -i LANG=$LANG /etc/init.d/foo start

/sbin/service --status-all

invokes all of the scripts in /etc/init.d/ with the 'status' command,
except for those which are obviously not suitable:  scripts
with filenames functions, halt, killall, single, linuxconf, kudzu,
and any scripts with filenames ending in
rpmorig, rpmnew, rpmsave, ~, or .orig.

SEE ALSO

serviceconf(1), ntsysv(8), chkconfig(8)

BUGS

if the OPTIONS environment variable is defined, then service
passes it to the init script ahead of the specified arguments.

The USAGE message should read

Usage: service --help | -h | -V | --version | --status-all | [ service_name [
command [ options... ] | --full-restart ] ]

instead of 

Usage: service < option > | --status-all | [ service_name [ command |
--full-restart ] ]



Additional info:

Comment 1 Edward J. Huff 2003-05-13 12:25:16 UTC
additional bug in script:  should use
env -i LANG="$LANG" ...

BUGS

if the LANG environment variable contains whitespace, then
/sbin/service will malfunction.

# LANG="C echo"
# service ntpd status
/etc/init.d/ntpd status
# LANG=C
# service ntpd status
ntpd (pid 1741) is running...


Comment 2 Bill Nottingham 2005-09-30 18:57:47 UTC

*** This bug has been marked as a duplicate of 44857 ***