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
                              LicenseMonitor.
  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