@@ -9,7 +9,9 @@ roundup-admin \- administrate roundup trackers
99Specify the issue tracker "home directory" to administer
1010.TP
1111\fB -u \fP \fI user \fP [\fB : \fP\fI password \fP ]
12- The user and password to use for commands
12+ The user and password to use for commands (partial implemention, see
13+ Security Notes below).
14+ .TP
1315\fB -h \fP
1416Print help text.
1517.TP
@@ -253,6 +255,28 @@ merged/updated config file is written to \fI<filename>\fP.
253255Commands may be abbreviated as long as the abbreviation
254256matches only one command, e.g. l == li == lis == list.
255257
258+ .SH SECURITY NOTES
259+
260+ The \fB -u user \fP setting does not currently operate like a
261+ user logging in via the web. The user running roundup-admin
262+ must have read access to the tracker home directory. As a
263+ result the user has access to the files and the database
264+ info contained in config.ini.
265+
266+ Using \fB -u user \fP sets the actor/user parameter in the
267+ journal. Changes that are made are attributed to that
268+ user. The password is ignored if provided. Any existing
269+ username has full access to the data just like the admin
270+ user. This is an area for further development so that
271+ roundup-admin could be used with sudo to provide secure
272+ command line access to a tracker.
273+
274+ .SH ENVIRONMENT VARIABLES
275+
276+ .TP
277+ \fB ROUNDUP_LOGIN \fP
278+ Provides an alternate way to set the user.
279+
256280.SH FURTHER HELP
257281 roundup-admin -h
258282 roundup-admin help -- this help
0 commit comments