wine-sc

wine sc command servicename [parameter= value ...]

wine sc is Wine's reimplementation of the Windows sc.exe service-control tool. It talks to the Service Control Manager in the current Wine prefix to create, query, start, stop, describe, and delete services.Create/config parameters use the Windows name= value form. A space after the equals sign is the documented Windows syntax (binpath= C:\foo.exe); current Wine also accepts binpath=C:\foo.exe with no space.The tool operates on the prefix named by WINEPREFIX (default ~/.wine). It is the counterpart of wine net, which only starts, stops, and lists running services. Remote-server syntax (\\\\server) is not implemented.

query service

Print type, state, and exit codes for the named service.

Create a service. binpath= is required. Optional create keys: displayname=, type= (own, share, kernel, filesys, rec, interact), start= (boot, system, auto, demand, disabled), error= (normal, severe, critical, ignore), group=, depend=, obj=, password=.

Start the service, then print its status. Extra arguments are passed to the service.

Stop the service, then print its status.

Set (or clear) the service description.

Set failure actions.

Remove the service from the service database.

Wine implements a subset of Windows sc: create, query, start, stop, delete, description, and failure. Other Windows verbs (config, qc, sdshow, ...) are not available. Creating a service only writes a database entry; the binpath= executable must actually exist in the prefix or start will fail. If the service is running, delete marks it for deletion until it stops.

Wine's sc.exe was added in 2010 by Hans Leidekker so Windows installers that register services through sc can run under Wine. Parsing of name=value (no space) was fixed in 2022.

wine(1), wine-net(1), wineserver(1), wineboot(1)

Source code · Homepage · Documentation