71 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			71 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.\" Copyright (c) 2008-2009 Roy Marples
 | 
						|
.\" All rights reserved
 | 
						|
.\"
 | 
						|
.\" Redistribution and use in source and binary forms, with or without
 | 
						|
.\" modification, are permitted provided that the following conditions
 | 
						|
.\" are met:
 | 
						|
.\" 1. Redistributions of source code must retain the above copyright
 | 
						|
.\"    notice, this list of conditions and the following disclaimer.
 | 
						|
.\" 2. Redistributions in binary form must reproduce the above copyright
 | 
						|
.\"    notice, this list of conditions and the following disclaimer in the
 | 
						|
.\"    documentation and/or other materials provided with the distribution.
 | 
						|
.\"
 | 
						|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 | 
						|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 | 
						|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 | 
						|
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 | 
						|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 | 
						|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 | 
						|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 | 
						|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 | 
						|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 | 
						|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 | 
						|
.\" SUCH DAMAGE.
 | 
						|
.\"
 | 
						|
.Dd May 1, 2009
 | 
						|
.Dt RC-SERVICE 8 SMM
 | 
						|
.Os OpenRC
 | 
						|
.Sh NAME
 | 
						|
.Nm rc-service
 | 
						|
.Nd locate and run an OpenRC service with the given arguments 
 | 
						|
.Sh SYNOPSIS
 | 
						|
.Nm
 | 
						|
.Op Fl i , -ifexists
 | 
						|
.Ar service cmd
 | 
						|
.Op Ar ...
 | 
						|
.Nm
 | 
						|
.Fl e , -exists
 | 
						|
.Ar service
 | 
						|
.Nm
 | 
						|
.Fl l , -list
 | 
						|
.Nm
 | 
						|
.Fl r , -resolve
 | 
						|
.Ar service
 | 
						|
.Sh DESCRIPTION
 | 
						|
Service scripts could be in different places on different systems. 
 | 
						|
.Nm
 | 
						|
locates the specified service and runs it with the given arguments.
 | 
						|
If
 | 
						|
.Fl i , -ifexists
 | 
						|
is given then
 | 
						|
.Nm
 | 
						|
returns 0 even if the service does not exist.
 | 
						|
.Pp
 | 
						|
If given the
 | 
						|
.Fl l , -list
 | 
						|
argument then
 | 
						|
.Nm
 | 
						|
will list all available services.
 | 
						|
.Pp
 | 
						|
.Fl e , -exists
 | 
						|
return 0 if it can find
 | 
						|
.Ar service ,
 | 
						|
otherwise -1.
 | 
						|
.Fl r , -resolve
 | 
						|
does the same and also prints the full path of the service to stdout.
 | 
						|
.Sh SEE ALSO
 | 
						|
.Xr rc 8 ,
 | 
						|
.Xr stdout 3
 | 
						|
.Sh AUTHORS
 | 
						|
.An Roy Marples <roy@marples.name>
 |