~ubuntu-branches/ubuntu/utopic/gridengine/utopic

« back to all changes in this revision

Viewing changes to doc/man/man1/sgepasswd.1

  • Committer: Bazaar Package Importer
  • Author(s): Mark Hymers
  • Date: 2008-06-25 22:36:13 UTC
  • Revision ID: james.westby@ubuntu.com-20080625223613-tvd9xlhuoct9kyhm
Tags: upstream-6.2~beta2
ImportĀ upstreamĀ versionĀ 6.2~beta2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
'\" t
 
2
.\"___INFO__MARK_BEGIN__
 
3
.\"
 
4
.\" Copyright: 2004 by Sun Microsystems, Inc.
 
5
.\"
 
6
.\"___INFO__MARK_END__
 
7
.\"
 
8
.\" $RCSfile$     Last Update: $Date$     Revision: $Revision$
 
9
.\"
 
10
.\"
 
11
.de SB          \" small and bold
 
12
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
 
13
..
 
14
.\"
 
15
.de T           \" switch to typewriter font
 
16
.ft CW          \" probably want CW if you don't have TA font
 
17
..
 
18
.\"
 
19
.de TY          \" put $1 in typewriter font
 
20
.if t .T
 
21
.if n ``\c
 
22
\\$1\c
 
23
.if t .ft P
 
24
.if n \&''\c
 
25
\\$2
 
26
..
 
27
.\"
 
28
.de M           \" man page reference
 
29
\\fI\\$1\\fR\\|(\\$2)\\$3
 
30
..
 
31
.TH SGE_PASSWD 1 "$Date$" "xxRELxx" "xxQS_NAMExx User Commands"
 
32
.SH NAME
 
33
sgepasswd \- Modify the xxQS_NAMExx password file of xxQS_NAMExx 
 
34
.\"
 
35
.\"
 
36
.SH SYNTAX
 
37
.B sgepasswd
 
38
[[
 
39
.B -D domain
 
40
]
 
41
.B -d user
 
42
 
43
.PP
 
44
.B sgepasswd
 
45
[
 
46
.B -D domain
 
47
] [
 
48
.B user
 
49
]
 
50
.\"
 
51
.SH DESCRIPTION
 
52
.I sgepasswd
 
53
modifies the xxQS_NAMExx password file 
 
54
.M sgepasswd 5 . 
 
55
.PP
 
56
This file contains a list of usernames and their windows password in 
 
57
encrypted form. 
 
58
.M sge_execd 8
 
59
and
 
60
.M sge_shepherd 8  
 
61
on hosts running Microsoft Windows as operating systems use this 
 
62
information to start jobs for a certain user. 
 
63
.PP
 
64
Each user can use the 
 
65
.I sgepasswd 
 
66
application to add a new entry for the own user account. It is also possible 
 
67
to change the stored password with 
 
68
.I sgepasswd 
 
69
as far as the user knows the old one.
 
70
.PP
 
71
The root user additionally has the permission to change the password entries 
 
72
for other user accounts. Root can also delete existing entries.
 
73
.PP
 
74
The 
 
75
.I sgepasswd 
 
76
binary is only available on non-Windows hosts.
 
77
.PP
 
78
.\"
 
79
.SH OPTIONS
 
80
.IP "\fB\-D domain\fP"
 
81
Per default 
 
82
.I sgepasswd 
 
83
will add/modify the current Unix username without domain specification.
 
84
This switch can be used to add a domain specification in front of the
 
85
current user name. Consult your Microsoft Windows documentation to get
 
86
more information about domain users. 
 
87
.\"
 
88
.IP "\fB\-d user\fP"
 
89
Only root can use this parameter to delete entries from the
 
90
.M sgepasswd 5 
 
91
file.
 
92
.\"
 
93
.IP "\fB\-help\fP"
 
94
Prints a listing of all options.
 
95
.\"
 
96
.SH "ENVIRONMENTAL VARIABLES"
 
97
.\" 
 
98
.IP "\fBSGE_CERTFILE\fP" 1.5i
 
99
Specifies the location of public key file. Per default 
 
100
.I sgepasswd
 
101
will use the file $SGE_ROOT/$SGE_CELL/common/sgeCA/certs/cert.pem
 
102
.\"
 
103
.IP "\fBSGE_KEYFILE\fP" 1.5i
 
104
If set, specifies the location of the private key file.
 
105
Default is /var/sgeCA/port${SGE_QMASTER_PORT}/private/key.pem
 
106
.\"
 
107
.SH "SEE ALSO"
 
108
.M xxqs_name_sxx_intro 1 ,
 
109
.M sgepasswd 5 
 
110
.\"
 
111
.SH "COPYRIGHT"
 
112
See
 
113
.M xxqs_name_sxx_intro 1
 
114
for a full statement of rights and permissions.