X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=registry%2Fimport.py;h=122c76fe7775d9b633f084d26f1df40844d415f7;hb=10e4f872f8a5880141b395c58456c55525b89100;hp=f7cc72598a873f10a897b62e4e86ff46176a1058;hpb=ac1398ae37ae4571d2b8c84ea742d43dcc78116b;p=sfa.git

diff --git a/registry/import.py b/registry/import.py
index f7cc7259..122c76fe 100644
--- a/registry/import.py
+++ b/registry/import.py
@@ -1,3 +1,17 @@
+##
+# Import PLC records into the Geni database. It is indended that this tool be
+# run once to create Geni records that reflect the current state of the
+# planetlab database.
+#
+# The import tool assumes that the existing PLC hierarchy should all be part
+# of "planetlab.us" (see the root_auth and level1_auth variables below).
+#
+# Public keys are extracted from the users' SSH keys automatically and used to
+# create GIDs. This is relatively experimental as a custom tool had to be
+# written to perform conversion from SSH to OpenSSL format. It only supports
+# RSA keys at this time, not DSA keys.
+##
+
 import getopt
 import sys
 import tempfile
@@ -11,6 +25,9 @@ from misc import *
 
 shell = None
 
+##
+# Two authorities are specified: the root authority and the level1 authority.
+
 root_auth = "planetlab"
 level1_auth = "planetlab.us"