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

Parameter Type Description
ticket_ids hexadecimal Specifies Hex value of each ticket ID to be removed. This parameter is optional. This parameter can specify several values separated by spaces.
reply_file string Specifies full file name of job request file. This parameter is optional.
force boolean This parameter is optional.
Return Type Description
None None

Error Codes

Error Code Description
None Specify 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.
None Parameter '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}