Dear portmgr,FWIW, I do not like the new knob. BROKEN_SINCE can be inferred from the
In light of today's ports removal I feel like we need to improve the
process around broken ports a bit. Diizzy's actions reflect a common
failure mode we see in the tree:
- maintainer falls absent
- port falls into disrepair and breaks
- nobody is alerted of the breakage and those who notice believe that
there is a maintainer and do not take action
- eventually someone notices that the port has been broken for *very
long* and removes it outright (permitted within policy)
I propose the following policy changes to improve the situation:
- Committers are encouraged to mark ports that do not build anywhere
as BROKEN if they believe the breakage reason to be of a kind that
will not resolve itself shortly (e.g. temporary mirror outage). If
the port is only broken in some configurations (some OSVERSION, some
ARCH), the appropriate BROKEN_${ARCH} etc. should be used. When in
doubt, committers can check the pkg repos or freshports for binary
package presence to ascertain whether the port builds in any
configuration
- A new variable BROKEN_SINCE= YYYY-mm-dd is added, which should be
set to when the breakge was first noticed when the port is marked as
BROKEN. It should not be set for BROKEN_*, only for complete breakage.
This is when *you* the committer noticed that the port was broken.
- Before marking the port as BROKEN, check if there are any patches aroundWhat about active maintainers that deliberately marked their ports BROKEN?
that could fix it. Prefer applying such patches under build fix blanket
approval over marking the port as BROKEN. This is not a mandatory step,
but you are strongly encouraged to follow it.
- Make sure to commit BROKEN and BROKEN_SINCE without delay once you
notice the breakage.
- Three months from BROKEN_SINCE, maintainership reverts to
ports@FreeBSD.org except in the case of group maintainerships.
At the same time, an EXPIRATION_DATE is added three months from
that date. This process should be automated by means of a cron job.
- Broken ports may only be removed without going through this processFully agree.
or without maintainer approval (this may be through maintainer timeout)
if they are clearly beyond rescue. This includes cases like
* The port is only available for an architecture that is no longer
supported.
* The port requires an OS feature that is no longer present and that
cannot be supplied as a third-party dependency.
* The port is not legally redistributable.
* Upstream has requested we do not ship the port.
* A mandatory dependency of the port has been removed and the port
cannot be patched to no longer require it.
* The port is unfetchable and it will not be possible to make it fetchable.
Please follow the BROKEN process for unfetchable ports unless you
are absolutely sure that no new upstream / hoster will ever be found.
- Committers and third-party contributors are encouraged to step up and
fix BROKEN ports under the established build fix policy without explicit
maintainer approval. If they find the maintainer to be absent, they are
encouraged to claim maintainership or revert it to ports@FreeBSD.org under
the standard policies for maintainer timeout and absentee maintainers.
- A port that is deleted and re-added must follow the same rules as any
other new port. In particular, there must be a maintainer who has
explicitly agreed to maintain the port. This can be a group
maintainership.
On 2026-10-27 09:50, Jochen Neumeister wrote:
Hi all,
Robert's proposal touches a real problem: ports that stay BROKEN for
months while nobody feels responsible. Releasing such ports to ports@
can help, because it makes clear that anyone may step in and fix them.
To Gleb's point, it should not hit active maintainers who set BROKEN
on purpose while waiting for an upstream release.
What I miss in this thread is the order of steps. Most of the
discussion is about when a port may be removed. Shouldn't the first
goal be to fix it?
If a project is dead, for example the repository has seen no activity
for years and the code no longer builds, there is nothing wrong with removing the port. If the project is alive, the port should get the
chance to be fixed first. For Budgie, the fix had been available
upstream since November 2025 (10.9.4). For filesystems/darling-dmg, a
patch had been waiting in Bugzilla since September 27 (PR 298920),
and the maintainer timeout had already expired. Both ports were
removed anyway. Restoring, fixing and testing both took one evening,
which is less time than all of us have spent on this discussion.
These are not isolated cases. On October 4, 19 and 26 alone, 27 portsBROKEN stops generating packages, adding PORTREVISION, DEPRECATED etc
were removed from the tree in 21 commits because they were marked
BROKEN. None of them had been deprecated with DEPRECATED and EXPIRATION_DATE first. Two of them were not even broken themselves,
they only depended on a broken port. Users of these ports had no
chance to speak up.
wont do anything as that isn't propagated to pkg "top" metadata.
Running "pkg update" and "pkg upgrade" doesn't notify of anything, even
if the package is gone from upstream repo.
So adding DEPRECATED etc will do nothing in practice because that
information will never be propagated because the port (package) isn't
built in the first place.
If you're using ports you'll already see BROKEN.
It's applicable as long as the port actually builds however.
On 2026-10-28 01:17, Kevin Oberman wrote:Case in point, this is an extract from the system emails I receive.
On Tue, Oct 27, 2026 at 7:12rC>AM Daniel Engberg <diizzy@freebsd.org
<mailto:diizzy@freebsd.org>> wrote:
On 2026-10-27 09:50, Jochen Neumeister wrote:
> Hi all,
>
> Robert's proposal touches a real problem: ports that stay BROKEN for >> > months while nobody feels responsible. Releasing such ports to ports@ >> > can help, because it makes clear that anyone may step in and fix
them.
> To Gleb's point, it should not hit active maintainers who set BROKEN >> > on purpose while waiting for an upstream release.
>
> What I miss in this thread is the order of steps. Most of the
> discussion is about when a port may be removed. Shouldn't the first >> > goal be to fix it?
>
> If a project is dead, for example the repository has seen no activity >> > for years and the code no longer builds, there is nothing wrong with >> > removing the port. If the project is alive, the port should get the >> > chance to be fixed first. For Budgie, the fix had been available
> upstream since November 2025 (10.9.4). For filesystems/darling-dmg, a >> > patch had been waiting in Bugzilla since September 27 (PR 298920),
> and the maintainer timeout had already expired. Both ports were
> removed anyway. Restoring, fixing and testing both took one evening, >> > which is less time than all of us have spent on this discussion.
>
> These are not isolated cases. On October 4, 19 and 26 alone, 27 ports >> > were removed from the tree in 21 commits because they were marked
> BROKEN. None of them had been deprecated with DEPRECATED and
> EXPIRATION_DATE first. Two of them were not even broken themselves, >> > they only depended on a broken port. Users of these ports had no
> chance to speak up.
BROKEN stops generating packages, adding PORTREVISION, DEPRECATED etc
wont do anything as that isn't propagated to pkg "top" metadata.
Running "pkg update" and "pkg upgrade" doesn't notify of anything, even >> if the package is gone from upstream repo.
So adding DEPRECATED etc will do nothing in practice because that
information will never be propagated because the port (package) isn't
built in the first place.
If you're using ports you'll already see BROKEN.
It's applicable as long as the port actually builds however.
I see that Daniel is possibly unaware that DEPRECATED does do something
if you have the port in question installed. The periodic output, by
default, prints a list of all packages that have security issues in the
CVE-aand all ports that are deprecated. It also shows the date when the
port may be deleted. Assuming you run periodic/security, the log takes
care of making it evident to those using the port that it is deprecated
every day. E. g. "xmlto-0.0.28_3: Tag: deprecated Value: Depends on
vulnerable libxslt" and "xmlto-0.0.28_3: Tag: expiration_date Value:
2025-12-31".
--
Kevin Oberman, Part time kid herder and retired Network Engineer
E-mail: rkoberman@gmail.com <mailto:rkoberman@gmail.com>
Hi Kevin,
You're are correct in the sense that it does something but IF the port actually builds (and is installed). It doesn't work on ports that fails
to build and generate packages.
| Sysop: | Amessyroom |
|---|---|
| Location: | Fayetteville, NC |
| Users: | 76 |
| Nodes: | 6 (0 / 6) |
| Uptime: | 60:06:10 |
| Calls: | 1,265 |
| Calls today: | 1 |
| Files: | 1,362 |
| D/L today: |
4 files (9,632K bytes) |
| Messages: | 286,017 |