diff options
author | Rob Crittenden <rcritten@redhat.com> | 2007-10-11 10:49:32 -0400 |
---|---|---|
committer | Rob Crittenden <rcritten@redhat.com> | 2007-10-11 10:49:32 -0400 |
commit | 0a935d5be3677798ba01c274a9b61841704837ca (patch) | |
tree | bfe101fd7ad8197037764ea106ad38da70a66a46 /ipa-admintools/man | |
parent | dac58ee69321298925a1f8c403b0a443dd596a82 (diff) | |
download | freeipa-0a935d5be3677798ba01c274a9b61841704837ca.tar.gz freeipa-0a935d5be3677798ba01c274a9b61841704837ca.tar.xz freeipa-0a935d5be3677798ba01c274a9b61841704837ca.zip |
First draft of man pages for the admin tools
Diffstat (limited to 'ipa-admintools/man')
-rw-r--r-- | ipa-admintools/man/Makefile | 22 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-addgroup.1 | 47 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-adduser.1 | 80 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-delgroup.1 | 32 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-deluser.1 | 32 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-findgroup.1 | 34 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-finduser.1 | 40 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-groupmod.1 | 41 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-passwd.1 | 31 | ||||
-rw-r--r-- | ipa-admintools/man/ipa-usermod.1 | 41 |
10 files changed, 400 insertions, 0 deletions
diff --git a/ipa-admintools/man/Makefile b/ipa-admintools/man/Makefile new file mode 100644 index 000000000..9ede33982 --- /dev/null +++ b/ipa-admintools/man/Makefile @@ -0,0 +1,22 @@ +MANDIR = $(DESTDIR)/usr/share/man + +MANFILES=\ + ipa-addgroup.1 \ + ipa-adduser.1 \ + ipa-delgroup.1 \ + ipa-deluser.1 \ + ipa-findgroup.1 \ + ipa-finduser.1 \ + ipa-groupmod.1 \ + ipa-passwd.1 \ + ipa-usermod.1 + +all: ; + +install: + mkdir -p $(MANDIR)/man1 + @for i in $(MANFILES) ; do install -m 644 $$i $(MANDIR)/man1 ; gzip $(MANDIR)/man1/$$i ; done + +clean: + +test: diff --git a/ipa-admintools/man/ipa-addgroup.1 b/ipa-admintools/man/ipa-addgroup.1 new file mode 100644 index 000000000..a72d26d61 --- /dev/null +++ b/ipa-admintools/man/ipa-addgroup.1 @@ -0,0 +1,47 @@ +.\" A man page for ipa-addgroup +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-addgroup" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-addgroup \- Add a group + +.SH "SYNOPSIS" +ipa\-addgroup [\fIOPTION\fR]... \fIgroup\fR + +.SH "DESCRIPTION" +Adds a group with group name \fIgroup\fR. + +.SH "OPTIONS" +.TP +\fB\-d\fR, \fB\-\-description\fR=\fIdescription\fR +Set the description of the group to \fIdescription\fR. + +.TP +\fB\-g\fR, \fB\-\-gid\fR=\fIgid\fR +Set the gid for this group to \fIgid\fR. +If this option is not present, one is created automatically +by .B freeIPA. + +.PP +group and description are mandatory fields. If either of +these are not included on the command line you will be asked interactively. + +If no options are passed then all questions are asked. +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-adduser.1 b/ipa-admintools/man/ipa-adduser.1 new file mode 100644 index 000000000..514455c3c --- /dev/null +++ b/ipa-admintools/man/ipa-adduser.1 @@ -0,0 +1,80 @@ +.\" A man page for ipa-adduser +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-adduser" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-adduser \- Add a user + +.SH "SYNOPSIS" +ipa\-adduser [\fIOPTION\fR]... \fIuser\fR + +.SH "DESCRIPTION" +Adds a user with username \fIuser\fR. + +.SH "OPTIONS" +.TP +\fB\-c\fR, \fB\-\-gecos\fR=\fIgecos\fR +Set the \f[SM]GECOS\fR field to \fIgecos\fR. +The \f[SM]GECOS\fR field is traditionally used to store user's real name and other information. + +.TP +\fB\-d\fR, \fB\-\-directory\fR=\fIdirectory\fR +Set user's home directory to \fIdirectory\fR. +If this option is not present, a default specified by the +.B freeIPA configuration is used. + +.TP +\fB\-f\fR, \fB\-\-firstname\fR=\fIgivenName\fR +Set user's first name to \fIgivenName\fR. + +.TP +\fB\-l\fR, \fB\-\-lastname\fR=\fIfamilyName\fR +Set user's last name to \fIfamilyName\fR. + +.TP +\fB\-p\fR, \fB\-\-password\fR=\fIpassword\fR +Set user's password to \fIpassword\fR. + +.TP +\fB\-s\fR, \fB\-\-shell\fR=\fIshell\fR +Set the user's login shell to \fIshell\fR. +If this option is not present, a default specified by the +.B freeIPA configuration is used. + +.TP +\fB\-G\fR, \fB\-\-groups\fR=\fIgroups\fR +Add this user to one or more groups in \fIgroups\fR. +\fIgroups\fR is a comma\-separated list of groups. +Each \fIgroup\fR must already exist. + +.TP +\fB\-k\fR, \fB\-\-krb\-principal\fR=\fIprincipal\fR +Set this user's principal to \fIprincipal\fR. +By default the principal is set to \fBuser\fR. + +.TP +\fB\-M\fR, \fB\-\-mailAddress\fR=\fImail\fR +Set this user's e\-mail address to \fImail\fR. + +.PP +The mandatory fields are: user, first name, last name and password. If any of these are not included on the command line you will be asked interactively. + +If no options are passed then all questions are asked. +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-delgroup.1 b/ipa-admintools/man/ipa-delgroup.1 new file mode 100644 index 000000000..0e6372293 --- /dev/null +++ b/ipa-admintools/man/ipa-delgroup.1 @@ -0,0 +1,32 @@ +.\" A man page for ipa-delgroup +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-delgroup" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-delgroup \- Delete a group + +.SH "SYNOPSIS" +ipa\-delgroup \fIgroup\fR + +.SH "DESCRIPTION" +Deletes a group with group name \fIgroup\fR. + +Members of the group are not affected. +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-deluser.1 b/ipa-admintools/man/ipa-deluser.1 new file mode 100644 index 000000000..ab0303d75 --- /dev/null +++ b/ipa-admintools/man/ipa-deluser.1 @@ -0,0 +1,32 @@ +.\" A man page for ipa-deluser +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-deluser" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-deluser \- Delete a user + +.SH "SYNOPSIS" +ipa\-deluser \fIuser\fR + +.SH "DESCRIPTION" +Deletes a user with name \fIname\fR. + +Users are not completely removed with the command, just marked as inactive. +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-findgroup.1 b/ipa-admintools/man/ipa-findgroup.1 new file mode 100644 index 000000000..29b60797b --- /dev/null +++ b/ipa-admintools/man/ipa-findgroup.1 @@ -0,0 +1,34 @@ +.\" A man page for ipa-findgroup +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-findgroup" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-findgroup \- Find a group + +.SH "SYNOPSIS" +ipa\-findgroup \fIstring\fR + +.SH "DESCRIPTION" +Searches for a group that contains \fIstring\fR. + +The search is a substring search in the name and description attributes. + +All entries that match are displayed. +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-finduser.1 b/ipa-admintools/man/ipa-finduser.1 new file mode 100644 index 000000000..ab7a01fe0 --- /dev/null +++ b/ipa-admintools/man/ipa-finduser.1 @@ -0,0 +1,40 @@ +.\" A man page for ipa-finduser +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-finduser" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-finduser \- Find a user +.SH "SYNOPSIS" +ipa\-finduser [\fIOPTION\fR]... \fIstring\fR + +.SH "DESCRIPTION" +Searches for a user that contains \fIstring\fR. + +The search is a substring search in the username, given name, family name, telephone Number, organization and title attributes. + +All entries that match are displayed. +.SH "OPTIONS" +.TP +\fB\-a\fR, \fB\-\-all +Display all attributes + +.PP +By default the full name, home Directory and login shell and username fields are displayed. +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-groupmod.1 b/ipa-admintools/man/ipa-groupmod.1 new file mode 100644 index 000000000..5b9925468 --- /dev/null +++ b/ipa-admintools/man/ipa-groupmod.1 @@ -0,0 +1,41 @@ +.\" A man page for ipa-groupmod +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-groupmod" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-groupmod \- Modify a group +.SH "SYNOPSIS" +ipa\-groupmod [\fIOPTION\fR]... \fIgroup\fR + +.SH "DESCRIPTION" +Updates the members or description of \fIgroup\fR. +.SH "OPTIONS" +.TP +\fB\-a\fR, \fB\-\-add\fR=\fIuser1,user2,...usern\fR +Add one or more users to the group + +.TP +\fB\-d\fR, \fB\-\-description\fR=\fIdescription\fR +Modify the description of the group + +.TP +\fB\-r\fR, \fB\-\-remove\fR=\fIuser1,user2,...usern\fR +Remove one or more users from the group +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-passwd.1 b/ipa-admintools/man/ipa-passwd.1 new file mode 100644 index 000000000..04c46be2c --- /dev/null +++ b/ipa-admintools/man/ipa-passwd.1 @@ -0,0 +1,31 @@ +.\" A man page for ipa-passwd +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-passwd" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-passwd \- Change a user's password +.SH "SYNOPSIS" +ipa\-password [\fIuser\fR] + +.SH "DESCRIPTION" +Changes the current user's password. If a \fIuser\fR is included on the command\-line then that user's password is modified. + +The user is the name in the kerberos principal, so it may not match username. +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. diff --git a/ipa-admintools/man/ipa-usermod.1 b/ipa-admintools/man/ipa-usermod.1 new file mode 100644 index 000000000..760e6d057 --- /dev/null +++ b/ipa-admintools/man/ipa-usermod.1 @@ -0,0 +1,41 @@ +.\" A man page for ipa-usermod +.\" Copyright (C) 2007 Red Hat, Inc. +.\" +.\" This is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU Library General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, but +.\" WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +.\" General Public License for more details. +.\" +.\" You should have received a copy of the GNU Library General Public +.\" License along with this program; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.\" +.\" Author: Rob Crittenden <rcritten@redhat.com> +.\" +.TH "ipa-usermod" "1" "Oct 10 2007" "freeipa" "" +.SH "NAME" +ipa\-usermod \- Modify a user +.SH "SYNOPSIS" +ipa\-usermod [\fIOPTION\fR]... \fIgroup\fR + +.SH "DESCRIPTION" +Updates the members or description of \fIgroup\fR. +.SH "OPTIONS" +.TP +\fB\-a\fR, \fB\-\-add\fR=\fIuser1,user2,...usern\fR +Add one or more users to the group + +.TP +\fB\-d\fR, \fB\-\-description\fR=\fIdescription\fR +Modify the description of the group + +.TP +\fB\-r\fR, \fB\-\-remove\fR=\fIuser1,user2,...usern\fR +Remove one or more users from the group +.SH "EXIT STATUS" +The exit status is 0 on success, nonzero on error. |