ftlm_accounts
Utility to show and manage user project and custom group definitions.
ftlm_accounts: Usage Message
Utility to show and manage user project and custom group definitions.
USAGE:
ftlm_accounts [OPTIONS] <ACTION> ....
PROJECT ACTIONS:
showdb - Show ALL project assignments found for each user
in the database. For users with no project
assignments, the default of "none" is printed.
autofill - Automatically assign projects to users by
searching for previously assigned projects. The
most frequently used project is assigned. If
none are found, a warning is printed.
setdb <users> <project> - Assign a project to one or more users. If a
user is not already in the database, an error is
printed for that user. To clear all project
assignments for the specified user(s), pass ""
as the <project>.
reset - Clear all project assignments for all users.
WARNING: This is destructive and can take a
while.
showlive - Show project assignments that are to be applied
to new checkouts as they occur.
setlive <users> <project> - Assign a default project to one or more users
for checkouts that will be detected by Monitor.
setliveall - Assign a default project for all live checkouts
based on the definitions in the project
configuration.
clearlive - Clear all live project assignments.
PROJECT OPTIONS:
-origin <N> - Restrict to given origin.
CUSTOM GROUP ACTIONS:
addmembership - Deprecated. Use addusermembership.
addhostmembership - Add a host to a host-based custom
<type> <group> <host> group. If overlap is detected, an
<startDateSpec> <endDateSpec> extension to the existing membership
is made.
addusermembership - Add a user to a user-based custom
<type> <group> <user> group. If overlap is detected, an
<startDateSpec> <endDateSpec> extension to the existing membership
is made.
backdatememberships - Backdate the start time of
<TIMESPEC> [type] [group] memberships that belong to the
optionally specified type or
type/group pair. If no type is
passed, all memberships will be back-
dated. TIMESPEC may be specified as a
number of seconds or as a time
abbreviation such as 1m, 1h, 1d,
or 1w.
addgroup <type> <group> - Add a group of the specified type.
addgrouptype <membershipType> <type> - Add a group type based on the specified
membership type (user or host).
renamegroup <old> <new> - Rename a group.
renamegrouptype <old> <new> - Rename a group type.
deletegroup <type> <group> - Delete a group.
deletegrouptype <type> - Delete a group type.
deletemember - Delete all memberships for the member
<type> <group> <member> and group specified.
deletemembership - Delete a specific membership for the
<type> <group> <member> member and group specified. Times
<startDateSpec> <endDateSpec> must match an existing membership
exactly.
dumpmemberships - Dump existing memberships in config
file format.
loadfromfile [external file path] - Load membership information from
configuration file. Default file is
licmon.swd/config/accounts.cfg.
Optionally, an external file may be
specified.
loadfromoptions - Load membership information from
[external file path] FLEXlm options file. Specify a group
<groupType> <optionsGroupList> type and the options file group(s)
that will be used to populate a group
by the same name. To use all groups,
specify "all".
A user cannot be a member of more
than one group of the same type, so
make sure different group types are
specified for each group that
contains a common user.
showgroups <type> - Show custom groups of specified type.
showgrouptypes - Show custom group types.
showmembers <type> <group> - Show group members.
showmemberships - Deprecated. Use showusermemberships.
showhostmemberships <host> - Show group memberships for the
specified host.
showusermemberships <user> - Show group memberships for the
specified user.
updatemembership - Update a membership. Times must match
<type> <group> <member> an existing membership exactly. This
<oldStartDateSpec> <oldEndDateSpec> is normally used to shorten a
<newStartDateSpec> <newEndDateSpec> membership due to how the
addmembership action creates
extensions upon overlap.
ABOUT CUSTOM GROUP DATESPECS:
Times may be specified in the following formats:
10-digit UNIX timestamp
YYYYMMDD
YYYY-MM-DD
Full date shown in "ftlm_accounts -showmemberships" output
Examples:
ftlm_accounts deletemembership location "San Jose" joe 1293655667 1293655668
ftlm_accounts deletemembership location "San Jose" joe 20100101 20110101
COMMON OPTIONS:
-f - Force flag (use with reset to avoid dialog).
-v - Increase verbosity.
-h - This help.
EXAMPLES: DATABASE MANIPULATION:
% ftlm_accounts setdb "john mary dan" "ChipA"
% ftlm_accounts reset
% ftlm_accounts -f reset
% ftlm_accounts autofill
EXAMPLES: NEW CHECKOUTS:
% ftlm_accounts showlive
% ftlm_accounts setlive "john mary dan" "ChipA"
% ftlm_accounts setliveall
% ftlm_accounts clearlive
SEE ALSO:
ftlm_lmproject