Makefile.am | 4 +
Makefile.in | 6 ++
man/man8/register-ds-admin.pl.8 | 95 ++++++++++++++++++++++++++++++++++++++++
man/man8/restart-ds-admin.8 | 43 ++++++++++++++++++
man/man8/start-ds-admin.8 | 43 ++++++++++++++++++
man/man8/stop-ds-admin.8 | 43 ++++++++++++++++++
6 files changed, 233 insertions(+), 1 deletion(-)
New commits:
commit 0f3e558ee448d4c6fac283788265e380db970cbb
Author: Nathan Kinder <nkinder(a)redhat.com>
Date: Tue Jun 8 12:39:35 2010 -0700
Bug 601865 - Add missing man pages
This adds man pages for the start-ds-admin, stop-ds-admin,
restart-ds-admin, and register-ds-admin.pl commands.
diff --git a/Makefile.am b/Makefile.am
index 074f8bc..4eba85d 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -212,6 +212,10 @@ perl_DATA = admserv/newinst/src/ASDialogs.pm \
#------------------------
dist_man_MANS = man/man8/migrate-ds-admin.pl.8 \
man/man8/setup-ds-admin.pl.8 \
+ man/man8/start-ds-admin.8 \
+ man/man8/stop-ds-admin.8 \
+ man/man8/register-ds-admin.pl.8 \
+ man/man8/restart-ds-admin.8 \
man/man8/remove-ds-admin.pl.8
#------------------------
diff --git a/Makefile.in b/Makefile.in
index 98ffde1..70ef7cc 100755
--- a/Makefile.in
+++ b/Makefile.in
@@ -624,6 +624,10 @@ perl_DATA = admserv/newinst/src/ASDialogs.pm \
#------------------------
dist_man_MANS = man/man8/migrate-ds-admin.pl.8 \
man/man8/setup-ds-admin.pl.8 \
+ man/man8/start-ds-admin.8 \
+ man/man8/stop-ds-admin.8 \
+ man/man8/register-ds-admin.pl.8 \
+ man/man8/restart-ds-admin.8 \
man/man8/remove-ds-admin.pl.8
@@ -2205,7 +2209,7 @@ distdir: $(DISTFILES)
|| exit 1; \
fi; \
done
- -find $(distdir) -type d ! -perm -777 -exec chmod a+rwx {} \; -o \
+ -find $(distdir) -type d ! -perm -755 -exec chmod a+rwx,go+rx {} \; -o \
! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
! -type d ! -perm -400 -exec chmod a+r {} \; -o \
! -type d ! -perm -444 -exec $(SHELL) $(install_sh) -c -m a+r {} {} \; \
diff --git a/man/man8/register-ds-admin.pl.8 b/man/man8/register-ds-admin.pl.8
new file mode 100644
index 0000000..a54537c
--- /dev/null
+++ b/man/man8/register-ds-admin.pl.8
@@ -0,0 +1,95 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH REGISTER-DS-ADMIN.PL 8 "Jun 8, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+register\-ds\-admin.pl \- Registers Directory Server instances with an Admin Server
+.SH SYNOPSIS
+.B register-ds-admin.pl
+[\fI--options\fR] \fI-- \fR[\fIargs\fR]
+.SH DESCRIPTION
+Registers existing Directory Server instances with an existing Admin Server.
+This command does the set up necessary for the use of the Console to manage
+the Directory Server instances you are registering.
+
+Use this command with the \fB--update\fR option after an upgrade to refresh the server
information (version, build number, etc.) in the Console.
+
+Can be run in interactive mode with different levels of verbosity, or
+in silent mode with parameters supplied in a .inf format file or
+on the command line.
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+.SH OPTIONS
+A summary of options is included below:
+.TP
+.B \fB\-\-help\fR
+This message
+.TP
+.B \fB\-\-version\fR
+Print the version and exit
+.TP
+.B \fB\-\-debug\fR
+Turn on debugging
+.TP
+.B \fB\-\-silent\fR
+Use silent setup \- no user input
+.TP
+.B \fB\-\-file\fR=\fIname\fR
+Use the file 'name' in .inf format to supply the default answers
+.TP
+.B \fB\-\-keepcache\fR
+Do not delete the temporary .inf file generated by this program
+.TP
+.B \fB\-\-logfile\fR
+Log setup messages to this file \- otherwise, a temp file will be used
+.TP
+.B \fB\-\-update\fR
+Update an existing installation (e.g. after upgrading packages)
+.TP
+.B \fB\-\-continue
+(update only) keep going despite errors (also --force)
+.PP
+For all options, you can also use the short name e.g. \fB\-h\fR, \fB\-d\fR, etc. For the
\fB\-d\fR argument,
+specifying it more than once will increase the debug level e.g. \fB\-ddddd\fR
+.PP
+args:
+You can supply default .inf data in this format:
+.IP
+section.param=value
+.PP
+e.g.
+.IP
+General.FullMachineName=foo.example.com
+.PP
+or
+.IP
+"slapd.Suffix=dc=example, dc=com"
+.PP
+Values passed in this manner will override values in an .inf file given with the
\fB\-f\fR argument.
+.br
+.SH AUTHOR
+register-ds-admin.pl was written by the 389 Project.
+.SH "REPORTING BUGS"
+Report bugs to
http://bugzilla.redhat.com.
+.SH COPYRIGHT
+Copyright \(co 2010 Red Hat, Inc.
+.br
+This is free software. You may redistribute copies of it under the terms of
+the Directory Server license found in the LICENSE file of this
+software distribution. This license is essentially the GNU General Public
+License version 2 with an exception for plug-in distribution.
diff --git a/man/man8/restart-ds-admin.8 b/man/man8/restart-ds-admin.8
new file mode 100644
index 0000000..f6d3e56
--- /dev/null
+++ b/man/man8/restart-ds-admin.8
@@ -0,0 +1,43 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH RESTART-DS-ADMIN 8 "Jun 8, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+restart-ds-admin \- restart script for Admin Server
+.SH SYNOPSIS
+.B restart-ds-admin
+.SH DESCRIPTION
+restart-ds-admin restarts the Admin Server instance
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+.SH USAGE
+Sample usage:
+.TP
+.B restart-ds-admin
+.br
+.SH AUTHOR
+restart\-ds\-admin was written by the 389 Project.
+.SH "REPORTING BUGS"
+Report bugs to
http://bugzilla.redhat.com.
+.SH COPYRIGHT
+Copyright \(co 2010 Red Hat, Inc.
+.br
+This is free software. You may redistribute copies of it under the terms of
+the Directory Server license found in the LICENSE file of this
+software distribution. This license is essentially the GNU General Public
+License version 2 with an exception for plug-in distribution.
diff --git a/man/man8/start-ds-admin.8 b/man/man8/start-ds-admin.8
new file mode 100644
index 0000000..420a5a0
--- /dev/null
+++ b/man/man8/start-ds-admin.8
@@ -0,0 +1,43 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH START-DS-ADMIN 8 "Jun 8, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+start-ds-admin \- start script for Admin Server
+.SH SYNOPSIS
+.B start-ds-admin
+.SH DESCRIPTION
+start-ds-admin starts the Admin Server instance
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+.SH USAGE
+Sample usage:
+.TP
+.B start-ds-admin
+.br
+.SH AUTHOR
+start\-ds\-admin was written by the 389 Project.
+.SH "REPORTING BUGS"
+Report bugs to
http://bugzilla.redhat.com.
+.SH COPYRIGHT
+Copyright \(co 2010 Red Hat, Inc.
+.br
+This is free software. You may redistribute copies of it under the terms of
+the Directory Server license found in the LICENSE file of this
+software distribution. This license is essentially the GNU General Public
+License version 2 with an exception for plug-in distribution.
diff --git a/man/man8/stop-ds-admin.8 b/man/man8/stop-ds-admin.8
new file mode 100644
index 0000000..178bcf9
--- /dev/null
+++ b/man/man8/stop-ds-admin.8
@@ -0,0 +1,43 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH STOP-DS-ADMIN 8 "Jun 8, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+stop-ds-admin \- stop script for Admin Server
+.SH SYNOPSIS
+.B stop-ds-admin
+.SH DESCRIPTION
+stop-ds-admin stops the Admin Server instance
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+.SH USAGE
+Sample usage:
+.TP
+.B stop-ds-admin
+.br
+.SH AUTHOR
+stop\-ds\-admin was written by the 389 Project.
+.SH "REPORTING BUGS"
+Report bugs to
http://bugzilla.redhat.com.
+.SH COPYRIGHT
+Copyright \(co 2010 Red Hat, Inc.
+.br
+This is free software. You may redistribute copies of it under the terms of
+the Directory Server license found in the LICENSE file of this
+software distribution. This license is essentially the GNU General Public
+License version 2 with an exception for plug-in distribution.