xdusage(1) XD Usage Command xdusage(1) NNAAMMEE xdusage- displays usage information for XSEDE projects SSYYNNOOPPSSIISS xxdduussaaggee [ --pp _p_r_o_j_e_c_t ] [ --rr _r_e_s_o_u_r_c_e ] [ --uu _u_s_e_r_n_a_m_e_|_L_a_s_t_n_a_m_e ] [ --uupp _p_o_r_t_a_l_-_u_s_e_r ] [ --aa ] [ --jj ] [ --ppaa ] [ --iipp ] [ --iiaa ] [ --zzpp ] [ --zzaa ] ] [ --nncc ] [ --ss _s_t_a_r_t_-_d_a_t_e ] [ --ee _e_n_d_-_d_a_t_e ] [ --VV ] [ --hh ] DDEESSCCRRIIPPTTIIOONN _x_d_u_s_a_g_e displays project and user account usage information for XSEDE projects. Information includes the usage, allocation, status, and dates of projects, as well as user account usage and status and, optionally, job-level information. _x_d_u_s_a_g_e with no options displays summary project and account usage information for the current user. By default, only unexpired projects are reported. OOPPTTIIOONNSS --pp _p_r_o_j_e_c_t display usage for the project(s) specified. See PROJECTS below. --rr _r_e_s_o_u_r_c_e Limit the output to allocations on the resource(s) specified. See ALLOCATIONS below. --uu _u_s_e_r_n_a_m_e_|_L_a_s_t_n_a_m_e Limit the output to usage for the user(s) specified (either by their username on the local machine or by their last name). See USERS below. --uupp _p_o_r_t_a_l_-_u_s_e_r Limit the output to usage for the user(s) specified by their portal login. See USERS below. --aa display usage for all user accounts. (This option is ignored with -u and -up) --jj display job data (as well as refunds, etc). --ppaa show previous allocation. (This option is ignored with -s and -e) See ALLOCATIONS below. --iipp suppress inactive projects. --iiaa suppress inactive accounts. --zzpp suppress projects with zero usage. --zzaa suppress user accounts with zero usage. --nncc do not use commas in the reported usage values. --ss _s_t_a_r_t_-_d_a_t_e --ee _e_n_d_-_d_a_t_e display usage for the period from _s_t_a_r_t_-_d_a_t_e through _e_n_d_-_d_a_t_e_. If --ee is specified, --ss must also be specfied. If --ss is speci- fied, but --ee is not specified, today is used for --ee.. Various formats of date can be used (see DATES below). --VV display version information. --hh display brief help on command usage. PPRROOJJEECCTTSS Projects, specified by --pp, are of the form TG-XXXXXXXXX, or just XXXXXXXX. If --pp is not specified, only those projects with non-expired allocations are reported. If --pp is specified, then the latest alloca- tion for those projects are reported (unless --ppaa is specified, and then the allocation just prior to the latest is reported). Mutiple projects can be specified by separating them with commas or with multiple --pp options: xdusage -p TG-XXXXXXX,TG-YYYYYYY -p ZZZZZZZZ A percent sign (%) can be used as a wildcard: xdusage -p TG-XX% NOTE: only projects that you have an account on will be reported. If you specify a project you are not on, xdusage will not show it. AALLLLOOCCAATTIIOONNSS Projects have allocations on one or more resources. There may be more than one allocation for a given project on a given resource. xdusage will show the latest allocation for each resource on a project, unless the --ppaa option is specfied, then the allocation previous to the latest will be show. If you wish to only see allocations on specific resources, use the --rr option: xdusage -r forge.ncsa.teragrid The resource name may be abbreviated xdusage -r forge Allocations may be inactive, either because they have expired or are out of funds. If the --pp option is not specified, then only allocations which are not expired will be shown (even if they are inactive) If --pp is used, then the latest allocations will be shown (even if they are expired or inactive) If you wish to only see active allocations, use the --iipp option. UUSSEERRSS By default, xdusage will only show your account usage. If you want to see usage for all users on the projects, specify the --aa option. If you want to only see usage for a specific user, specify the --uu or --uupp options. The --uu option requires either the username on the system you are running xdusage from, or the user's last name (capitalized first letter). Alternatively, if you know the portal username for a user, you can use the --uupp option. Mutiple users can be specified by separat- ing the names with commas or with multiple --uu or --uupp options: xdusage -u squinn,Shapiro -u Jones -up cpond A percent sign (%) can be used as a wildcard: xdusage -u S% DDAATTEESS The --ss and --ee options support a variety of date formats. Dates can be of the form YYYY-MM-DD (2012-01-15), MM/DD/YYYY (01/15/2012), M/D/YY (1/15/12). They can also use month names: 15Jan2012, "Jan 15, 2012". They can also be expressions: "1 week ago", "yesterday", "today", "5 months ago", "-12 days". AAUUTTHHOORR Michael Shapiro version 1.0 July 2012 xdusage(1)