loncom/lonnet/perl/lonnet.pm - diff

Return to lonnet.pm CVS log

Up to [LON-CAPA] / loncom / lonnet / perl

-version 1.747, 2006/06/07 21:38:25
+version 1.748, 2006/06/08 20:53:34
  Line 7565  cput($namespace,$storehash,$udom,$uname)
  =item *
+ newput($namespace,$storehash,$udom,$uname) :
+ Attempts to store the items in the $storehash, but only if they don't
+ currently exist, if this succeeds you can be certain that you have
+ successfully created a new key value pair in the $namespace db.
+ Args:
+  $namespace: name of database to store values to
+  $storehash: hashref to store to the db
+  $udom: (optional) domain of user containing the db
+  $uname: (optional) name of user caontaining the db
+ Returns:
+  'ok' -> succeeded in storing all keys of $storehash
+  'key_exists: <key>' -> failed to anything out of $storehash, as at
+                         least <key> already existed in the db (other
+                         requested keys may also already exist)
+  'error: <msg>' -> unable to tie the DB or other erorr occured
+  'con_lost' -> unable to contact request server
+  'refused' -> action was not allowed by remote machine
+ =item *
  eget($namespace,$storearr,$udom,$uname) : returns hash with keys from array
  reference filled in from namesp (encrypts the return communication)
  ($udom and $uname are optional)