# systemd-factory-reset

## NAME



           systemd-factory-reset, systemd-factory-reset-request.service,
           systemd-factory-reset-complete.service, systemd-factory-
           reset.socket, systemd-factory-reset@.service - Request or complete
           a factory reset operation, or query current factory reset mode
    


## SYNOPSIS



           /usr/lib/systemd/systemd-factory-reset
    
           systemd-factory-reset-request.service
    
           systemd-factory-reset-complete.service
    
           systemd-factory-reset.socket
    
           systemd-factory-reset@.service
    


## DESCRIPTION



           systemd-factory-reset is a tool that can query the current factory
           reset state, request factory request operations or complete them.
    
           Some of the functionality is also available via the
           /run/systemd/io.systemd.FactoryReset Varlink service (implemented
           via the
           systemd-factory-reset.socket/systemd-factory-reset@.service units.
    
           See **Factory Reset******[1] for an overview of the factory reset logic.


## COMMANDS



           The /usr/lib/systemd/systemd-factory-reset executable may also be
           invoked from the command line, taking one of the following command
           arguments:
    
           **status**
               Report current factory reset state. Reports one of
               "unsupported" (if the OS does not support a factory reset
               logic), "unspecified" (if no factory reset was requested, but
               it wasn't turned off explicitly either), "off" (if the factory
               reset logic was explicitly turned off via the kernel command
               line option), "on" (if the factory reset is currently enabled
               and executed), "complete" (if the factory reset logic ran
               during the current boot but is complete now), "pending" (if a
               factory reset has been requested for the next boot).
    
               Returns with an exit status of 0 if the factory reset
               mechanism is currently not in effect, 10 if a factory reset is
               currently being executed, or 11 if it is pending for the next
               boot.
    
               Added in version 258.
    
           **request**
               Request a factory reset operation to be executed on next boot.
    
               Note that this is a relatively low-level operation. The
               primary interface for requesting a factory reset operation is
               by starting the factory-reset.target unit.
    
               This sets the _FactoryResetRequested_ EFI variable, see below.
    
               This operation is executed when the
               systemd-factory-reset-request.service unit is started (which
               is typically one of the services hooked into and ordered
               before factory-reset.target).
    
               Added in version 258.
    
           **cancel**
               Cancel any previously requested (but not yet executed) factory
               reset operation.
    
               Added in version 258.
    
           **complete**
               Mark an ongoing factory reset operation as complete.
    
               This operation is executed when the
               systemd-factory-reset-complete.service unit is started (which
               is typically one of the services hooked into and ordered after
               factory-reset-now.target).
    
               Added in version 258.
    


## OPTIONS



           The following options are understood:
    
           **--retrigger**
               When used with the **complete** command retriggers all block
               devices, which might result in auto-discovered devices being
               usable that previously weren't because the factory reset logic
               was in place.
    
               Added in version 258.
    
           **--quiet** , **-q**
               Suppresses the state output of **status** , but still sets the exit
               status as documented.
    
               Added in version 258.
    
           **-h** , **--help**
               Print a short help text and exit.
    
           **--version**
               Print a short version string and exit.
    


## EFI VARIABLES



           The following EFI variable is set and read by
           **systemd-factory-reset** , under the vendor UUID
           "8cf2644b-4b0b-428f-9387-6d876050dc67", for communication between
           this boot and the next.
    
           _FactoryResetRequest_
               Set whenever a factory reset is requested from the next boot,
               deleted once the factory reset is complete. Contains JSON data
               describing the requesting OS, in order to avoid confusion in
               multi-boot systems.
    
               Added in version 258.
    


## NOTES



            1. Factory Reset
               https://systemd.io/FACTORY_RESET
    


* * *