Home Download News FAQ / Knowledge Base Screenshots Documentation Support
philosophical imaginary

Differences

This shows you the differences between two versions of the page.

documentation:appproto:users [2013/11/14 15:55]
dothebart [Table] fix reference.
documentation:appproto:users [2017/06/24 01:54] (current)
ajc [AGUP | ASUP (Administrative Get / Set User Parameters)]
Line 115: Line 115:
  
  
 +====  DLUI   (DownLoad User Image)  ====
 +Download the image (photo, icon, avatar, etc.) associated with a user account.  This command should be passed a single argument - the name of the user whose photo is requested.   If successful, DLUI returns data in the same format as the DLAT (DownLoad ATtachment) command: a BINARY_FOLLOWS code followed by three parameters - the number of bytes in the data, a filename (always empty), the Content-Type (such as image/gif), and the character set (always empty).
  
  
-====  LBIO   (List users who have BIOs on file)  ==== +====  ULUI   (UpLoad User Image)  ==== 
-This command is self-explanatory Any user who has used [[documentation:appproto:users#ebio.enter.biography|EBIO]] to place a bio on file is listed.  LBIO almost always returns [[documentation:appproto:statuscodes|LISTING_FOLLOWS]] followed by this listing, unless it experiences an internal error in which case [[documentation:appproto:statuscodes|ERROR]] is returned.+Upload the image (photo, icon, avatar, etc.) associated with a user account.  This command may be passed either two or three parameters:
  
 +^ No.  ^ Value                                                            ^
 +| 0    | Data length to be transmitted (in bytes)                         |
 +| 1    | MIME Content-Type of the data to be transmitted                  |
 +| 2    | (Optional) name of the user whose image is being uploaded.  If empty, assumes the currently logged in user. |
  
 +An error will occur if a user without administrative privileges attempts to change another user's photo, or if a nonexistent user is specified.
 +
 +If successful, a SEND_BINARY response will be delivered, along with the number of bytes expected.  The client MUST then transmit a binary blob containing that number of bytes.
  
  
  
 ====  AGUP | ASUP   (Administrative Get / Set User Parameters)  ==== ====  AGUP | ASUP   (Administrative Get / Set User Parameters)  ====
-These commands are only executable by Aides and by server extensions running at system-level.  They are used to get/set any and all parameters relating to a user account.  AGUP requires only one argument: the name of the user in question.  ASUP requires all of the parameters to be set.  The parameters are as follows, and are common to both commands:+These commands are only executable by administrators.  They are used to get/set any and all parameters relating to a user account.  AGUP requires only one argument: the name of the user in question.  ASUP requires all of the parameters to be set.  The parameters are as follows, and are common to both commands:
  
 ^ No.  ^ Value                                                            ^ ^ No.  ^ Value                                                            ^
Line 142: Line 151:
  
 If 1 to 8 are 0, the user will be scheduled for deletion; he will be unable to log in or send/receive email; His data will be removed on the next run of the [[documentation:appproto:system_config#tdap.manually.initate.the.dreaded.auto.purger|Autopurger]]; Until then, you won't be able to re-create a similar user. If 1 to 8 are 0, the user will be scheduled for deletion; he will be unable to log in or send/receive email; His data will be removed on the next run of the [[documentation:appproto:system_config#tdap.manually.initate.the.dreaded.auto.purger|Autopurger]]; Until then, you won't be able to re-create a similar user.
 +
 +==== AGEA (Administrative Get Email Addresses) ====
 +This command is only executable by administrators.  It is used to retrieve a list of Internet email addresses associated with a user account.  The sole parameter
 +to be passed is the name of the user being queried.
 +
 +If the current user is an administrator and the requested user account exists, AGEA will return OK followed by a delimited list of email addresses; otherwise
 +an appropriate error code is returned.
 +
 +==== ASEA (Administrative Set Email Addresses) ====
 +This command is only executable by administrators.  It is used to set the list of Internet email addresses associated with a user account.  If the current
 +user is an administrator and the requested user account exists, ASEA will return SEND_LISTING, at which time the client is expected to transmit a list of all
 +Internet email addresses to be associated with the account.  This list *replaces* any existing email addresses associated with the account.  Any addresses
 +that are invalid, or belong to domains not associated with the Citadel server, or belong to other users, will be silently discarded.
 +
 +If the current user is not an administrator or if the requested user account does not exist, an appropriate error code is returned.
  
 ==== RENU   (REName a User) ==== ==== RENU   (REName a User) ====
Copyright © 1987-2017 Uncensored Communications Group. All rights reserved.     Login (site admin)