REDROOM

Navigation

Breadcrumbs

Create

Preview: frontend.txt Size: 1.07 KB

//usr/share/doc/dpkg/frontend.txt

Frontend Interfaces
===================

This file will try to document some of the interfaces that dpkg makes
available to frontends or that expects them to use, which are currently
not covered by any other type of documentation.


Database Locking
----------------

Any frontend needing to make sure no write operation is currently happening,
and no other frontend is running should first acquire the frontend lock at
«<admindir>/lock-frontend», and then acquire the dpkg database lock at
«<admindir>/lock». When the frontend invokes dpkg, it should set the
environment variable DPKG_FRONTEND_LOCKED (to prevent dpkg from acquiring
the frontend lock), and then release the dpkg database lock, which will be
acquired by dpkg itself. This way no other frontend following this protocol
can race to perform operations while another one has one in progress.

These locks must be file record locks (i.e. fcntl(2) advisory locking), and
the whole file should be locked, as that's the most portable way to perform
this operation; this can be achieved by using start=0, len=0 and
whence=SEEK_SET.

Name	Size	Perms	Modified	Actions
AUTHORS	1.21 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive
changelog	676.07 KB	lrw-r--r--	2021-04-13 22:43:39	Edit Download recursive recursive
dpkg.cron.daily	1.27 KB	lrw-r--r--	2021-01-30 06:09:12	Edit Download recursive recursive
frontend.txt	1.07 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive
protected-field.txt	3.09 KB	lrw-r--r--	2021-01-30 06:09:02	Edit Download recursive recursive
README	3.46 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive
README.api	1.51 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive
README.bug-usertags	5.07 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive
README.feature-removal-schedule	5.62 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive
rootless-builds.txt	7.13 KB	lrw-r--r--	2021-01-30 06:09:12	Edit Download recursive recursive
THANKS	6.44 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive
TODO	5.20 KB	lrw-r--r--	2021-04-13 22:18:32	Edit Download recursive recursive
triggers.txt	35.76 KB	lrw-r--r--	2021-01-30 06:07:17	Edit Download recursive recursive

Directory Contents