21.16.5 remove_hsm_tickets

Description

This Tcl command removes HSM tickets from the HSM using one of the following methods:
  • By specifying the job reply file in which case all tickets that are in the reply file is deleted.
  • By specifying each of the ticket IDs value in hexadecimal string.
Important:
  • This command must be used very carefully as it removes HSM tickets, rendering any FlashPro Express jobs based on those tickets to be unusable.
  • This command does not require a FlashPro Express project to be created or opened.
remove_hsm_tickets [-ticket_ids "Ticket IDs to remove"] \
                   [-reply_file "Reply file containing ticket IDs to remove"] \
		   [-force "TRUE | FALSE"]

Arguments

ParameterTypeDescription
ticket_idshexadecimalSpecifies Hex value of each ticket ID to be removed. This parameter is optional. This parameter can specify several values separated by spaces.
reply_filestringSpecifies full file name of job request file. This parameter is optional.
forcebooleanThis parameter is optional.
Return TypeDescription
NoneNone

Error Codes

Error CodeDescription
NoneSpecify one of the required arguments: 'ticket_ids' or 'reply_file'.
None'value' is not a valid hex string. Specify a valid hex string for ticket ID.
NoneParameter 'param_name' is not defined. Valid command formatting is remove_hsm_tickets [-ticket_ids "[Ticket IDs to remove]+"] \ [-reply_file "Reply file containing ticket IDs to remove"] \ [-force "TRUE | FALSE"]'.

Supported Families

PolarFire®
SmartFusion® 2
IGLOO® 2
PolarFire SoC

Example

This example removes the HSM tickets from the HSM by specifying Job reply file:

remove_hsm_tickets \
		    -reply_file {D:flashpro_filesjobmgr_project12cm_reply.rep}

This example removes the HSM tickets from the HSM by specifying each of the ticket IDs value in hexadecimal string.

remove_hsm_tickets \
         -ticket_ids {00000000000000000000899f252d9fb55442aa7e 00000000000000000000b6f385c6a9eeca69705c 00000000000000000000ed5702d0b767ba686b82}