-
Notifications
You must be signed in to change notification settings - Fork 755
/
bsd.port.mk
5479 lines (4994 loc) · 179 KB
/
bsd.port.mk
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
#-*- tab-width: 4; -*-
# ex:ts=4
#
# bsd.port.mk - 940820 Jordan K. Hubbard.
# This file is in the public domain.
#
# Please view me with 4 column tabs!
# This is the master file for the most common elements to all port
# Makefile in the ports system. For a more general overview of its
# use and importance, see the Porter's Handbook.
# There are two different types of "maintainers" in the ports framework.
# The maintainer alias of the bsd.port.mk file is listed below in the
# FreeBSD_MAINTAINER entry. You should consult them if you have any
# questions/suggestions regarding this file.
#
# DO NOT COMMIT CHANGES TO THIS FILE BY YOURSELF, EVEN IF YOU DID NOT GET
# A RESPONSE FROM THE MAINTAINER(S) WITHIN A REASONABLE TIMEFRAME! ALL
# UNAUTHORISED CHANGES WILL BE UNCONDITIONALLY REVERTED!
FreeBSD_MAINTAINER= portmgr@FreeBSD.org
# For each port, the MAINTAINER variable is what you should consult for
# contact information on the person(s) to contact if you have questions/
# suggestions about that specific port. By default (if no MAINTAINER
# is listed), a port is maintained by the subscribers of the ports@FreeBSD.org
# mailing list, and any correspondence should be directed there.
#
# MAINTAINER - The e-mail address of the contact person for this port.
# Default: ports@FreeBSD.org
#
# These are meta-variables that are automatically set to the system
# you are running on. These are provided in case you need to take
# different actions for different values.
#
# ARCH - The architecture of the target machine, such as would be
# returned by "uname -p".
# OPSYS - Portability clause. This is the operating system the
# makefile is being used on. Automatically set to
# "FreeBSD," "NetBSD," or "OpenBSD" as appropriate.
# OSREL - The release version of the operating system as a text
# string (e.g., "12.2").
# OSVERSION - The operating system version as a comparable integer;
# the value of __FreeBSD_version (e.g., 1202000).
#
# This is the beginning of the list of all variables that need to be
# defined in a port, listed in order that they should be included
# to fit in with existing conventions. (Exception: MAINTAINER actually
# should appear after EXTRACT_ONLY and before MASTER_SITE_BACKUP).
#
# These variables are used to identify your port.
#
# PORTNAME - Name of software. Mandatory.
# PORTVERSION - Version of software. Mandatory when no DISTVERSION is given.
# PORTREVISION - Version of port. Optional. Commonly used to indicate
# that an update has happened that affects the port
# framework itself, but not the distributed software
# (e.g., local patches or Makefile changes).
# PORTEPOCH - Optional. In certain odd cases, the PORTREVISION logic
# can be fooled by ports that appear to go backwards
# numerically (e.g. if port-0.3 is newer than port-1998).
# In this case, incrementing PORTEPOCH forces the revision.
# Default: 0 (no effect).
# PKGNAME - Always defined as
# ${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}.
# Do not define this in your Makefile.
# PKGNAMEPREFIX - Prefix to specify that port is language-specific, etc.
# Optional.
# PKGNAMESUFFIX - Suffix to specify compilation options or a version
# designator (in case there are different versions of
# one port as is the case for Tcl).
# Optional.
# PKGVERSION - Always defined as ${PORTVERSION}.
# Do not define this in your Makefile.
# DISTVERSION - Vendor version of the distribution.
# Default: ${PORTVERSION}
# DISTNAME - Name of port or distribution used in generating
# WRKSRC and DISTFILES below.
# Default:
# ${PORTNAME}-${DISTVERSIONPREFIX}${DISTVERSION}${DISTVERSIONSUFFIX}
# CATEGORIES - A list of descriptive categories into which this port falls.
# Mandatory.
#
# These variable describe how to fetch files required for building the port.
#
# DISTFILES - Name(s) of archive file(s) containing distribution.
# Set this to an empty string if the port doesn't require it.
# Default: ${DISTNAME}${EXTRACT_SUFX}
# EXTRACT_SUFX - Suffix for archive names
# You never have to set both DISTFILES and EXTRACT_SUFX.
# Default: .tar.bz2 if USES=tar:bzip2 is set, .tar.xz if
# USES=tar:xz USE_XZ is set, .tar.gz otherwise).
# MASTER_SITES - Primary location(s) for distribution files if not found
# locally. See bsd.sites.mk for common choices for
# MASTER_SITES.
# MASTER_SITE_SUBDIR
# - Subdirectory of MASTER_SITES. Will sometimes need to be
# set to ${PORTNAME} for (e.g.) MASTER_SITE_SOURCEFORGE.
# Only guaranteed to work for choices of ${MASTER_SITES}
# defined in bsd.sites.mk.
# Default: not set.
# PATCHFILES - Name(s) of additional files that contain distribution
# patches. Make will look for them at PATCH_SITES (see below).
# They will automatically be uncompressed before patching if
# the names end with ".gz", ".bz2" or ".Z".
# For each file you can optionally specify a strip
# flag of patch(1) after a colon if it has a different
# base directory, e.g. "file1 file2:-p1 file3".
# You can also use a :group at the end for matching up to
# dist file groups. See Porters Handbook for more information.
# Syntax: PATCHFILES= patch[:-pX][:group]
# Default: not set.
# PATCH_SITES - Primary location(s) for distribution patch files
# if not found locally.
# DIST_SUBDIR - Suffix to ${DISTDIR}. If set, all ${DISTFILES} and
# ${PATCHFILES} will be put in this subdirectory of
# ${DISTDIR} (see below). Also they will be fetched in this
# subdirectory from FreeBSD mirror sites.
# ALLFILES - All of ${DISTFILES} and ${PATCHFILES}.
# EXTRACT_ONLY - If set, a subset of ${DISTFILES} you want to
# actually extract.
#
# (NOTE: by convention, the MAINTAINER entry (see above) should go here.)
#
# These variables are typically set in /etc/make.conf to indicate
# the user's preferred location to fetch files from. You should
# rarely need to set these.
#
# MASTER_SITE_BACKUP
# - Backup location(s) for distribution files and patch
# files if not found locally and ${MASTER_SITES}/${PATCH_SITES}.
# This should *not* be changed.
# Default:
# http://distcache.FreeBSD.org/ports-distfiles/${DIST_SUBDIR}/
# MASTER_SITE_OVERRIDE
# - If set, prepend the MASTER_SITES setting with this value.
# MASTER_SITE_FREEBSD
# - If set, prepend ${MASTER_SITE_BACKUP} in MASTER_SITES.
#
# Set these if your port should not be built under certain circumstances.
# These are string variables; you should set them to the reason why
# they are necessary.
#
# RESTRICTED - Prevent the distribution of distfiles and packages to
# the FTP sites or on CDROM (e.g. forbidden by license
# considerations).
# NO_CDROM - Packages and distfiles may not go on CDROM (e.g. must
# not be re-sold) but can go on FTP sites.
# NO_PACKAGE - Port should not be packaged for ftp sites or CDROMs,
# but distfiles can be put on ftp sites and CDROMs.
# FORBIDDEN - Package build should not be attempted because of
# security vulnerabilities.
# LEGAL_TEXT - Port has legal issues (e.g., special permission to distribute, lacks a license).
# LEGAL_PACKAGE - Port has no legal issues but defines NO_PACKAGE
# IGNORE - Package build should be skipped entirely (e.g.
# because of serious unfixable problems in the build,
# because it cannot be manually fetched, etc). Error
# logs will not appear on pointyhat, so this should be
# used sparingly.
# IGNORE_${ARCH} - Port should be ignored on ${ARCH}.
# IGNORE_${OPSYS} - Port should be ignored on ${OPSYS}.
# IGNORE_${OPSYS}_${OSREL:R} - Port should be ignored on a single
# release of ${OPSYS}, e.g IGNORE_FreeBSD_13
# would affect all point releases of FreeBSD 13.
# IGNORE_${OPSYS}_${OSREL:R}_${ARCH} - Port should be ignored on a
# single release of ${OPSYS} and specific architecture,
# e.g IGNORE_FreeBSD_13_i386 would affect all point
# releases of FreeBSD 13 in i386.
# BROKEN - Port is believed to be broken. Package builds can
# still be attempted using TRYBROKEN to test this
# assumption.
# BROKEN_${ARCH} - Port is believed to be broken on ${ARCH}. Package builds
# can still be attempted using TRYBROKEN to
# test this assumption.
# BROKEN_${OPSYS} - Port is believed to be broken on ${OPSYS}. Package builds
# can still be attempted using TRYBROKEN to
# test this assumption.
# BROKEN_${OPSYS}_${OSREL:R} - Port is believed to be broken on a single
# release of ${OPSYS}, e.g BROKEN_FreeBSD_13
# would affect all point releases of FreeBSD 13
# unless TRYBROKEN is also set.
# BROKEN_${OPSYS}_${OSREL:R}_${ARCH} - Port is believed to be broken on a
# single release of ${OPSYS} and specific architecture,
# e.g BROKEN_FreeBSD_13 would affect all point
# releases of FreeBSD 13 in i386
# unless TRYBROKEN is also set.
# DEPRECATED - Port is deprecated to install. Advisory only.
# EXPIRATION_DATE
# - If DEPRECATED is set, determines a date when
# the port is planed to remove. The date format is
# ISO 8601 (YYYY-MM-DD).
#
# DISABLE_VULNERABILITIES
# - If set, do not check if the port is listed in the
# vulnerabilities database.
#
# In addition to RESTRICTED or NO_CDROM, if only a subset of distfiles
# or patchfiles have redistribution restrictions, set the following
# to the list of such files.
#
# RESTRICTED_FILES
# - List of files that cannot be redistributed.
# Default: "${DISTFILES} ${PATCHFILES}" if RESTRICTED
# or NO_CDROM is set, empty otherwise.
#
# These variables are booleans, so you don't need to set them to the reason.
#
# IS_INTERACTIVE
# - Set this if your port needs to interact with the user
# during any step in a package build. User can then decide
# to skip this port by setting ${BATCH}, or compiling only
# the interactive ports by setting ${INTERACTIVE}.
# Default: not set.
# USE_SUBMAKE - Set this if you want that each of the port's main 7 targets
# (extract, patch, configure, build, stage, install and
# package) to be executed in a separate make(1) process.
# Useful when one of the stages needs to influence make(1)
# variables of the later stages using ${WRKDIR}/Makefile.inc
# generated on the fly.
# Default: not set.
#
# NO_ARCH - Set this if port is architecture neutral.
#
# NO_ARCH_IGNORE - Set this to a list files to ignore when NO_ARCH is checked
# in stage-qa (i.e. architecture specific files that are
# 'bundled' with the port).
#
# Set these if your port only makes sense to certain architectures.
# They are lists containing names for them (e.g., "amd64 i386").
# (Defaults: not set.)
#
# ONLY_FOR_ARCHS
# - Only build ports if ${ARCH} matches one of these.
# NOT_FOR_ARCHS - Only build ports if ${ARCH} doesn't match one of these.
# ONLY_FOR_ARCHS_REASON
# ONLY_FOR_ARCHS_REASON_${ARCH}
# - Reason why it's only for ${ONLY_FOR_ARCHS}s
# NOT_FOR_ARCHS_REASON
# NOT_FOR_ARCHS_REASON_${ARCH}
# - Reason why it's not for ${NOT_FOR_ARCHS}s
# IA32_BINARY_PORT
# - Set this instead of ONLY_FOR_ARCHS if the given port
# fetches and installs compiled i386 binaries.
#
# Dependency checking. Use these if your port requires another port
# not in the list below. (Default: empty.)
#
# EXTRACT_DEPENDS
# - A list of "path:dir[:target]" tuples of other ports this
# package depends on in the "extract" stage. "path" is
# the name of a file if it starts with a slash (/), an
# executable otherwise. make will test for the existence
# (if it is a full pathname) or search for it in your
# $PATH (if it is an executable) and go into "dir" to do
# a "make all install" if it's not found. If the third
# field ("target") exists, it will be used instead of
# ${DEPENDS_TARGET}. The first field also supports a
# package name with a version range, in the form package>=1.2
# if a particular version is desired.
# PATCH_DEPENDS - A list of "path:dir[:target]" tuples of other ports this
# package depends on in the "patch" stage. "path" is the
# name of a file if it starts with a slash (/), an
# executable otherwise. make will test for the existence
# (if it is a full pathname) or search for it in your
# $PATH (if it is an executable) and go into "dir" to do
# a "make all install" if it's not found. If the third
# field ("target") exists, it will be used instead of
# ${DEPENDS_TARGET}. The first field also supports a
# package name with a version range, in the form package>=1.2
# if a particular version is desired.
# FETCH_DEPENDS - A list of "path:dir[:target]" tuples of other ports this
# package depends in the "fetch" stage. "path" is the
# name of a file if it starts with a slash (/), an
# executable otherwise. make will test for the
# existence (if it is a full pathname) or search for
# it in your $PATH (if it is an executable) and go
# into "dir" to do a "make all install" if it's not
# found. If the third field ("target") exists, it will
# be used instead of ${DEPENDS_TARGET}. The first field
# also supports a package name with a version range, in
# the form package>=1.2 if a particular version is desired.
# BUILD_DEPENDS - A list of "path:dir[:target]" tuples of other ports this
# package depends to build (between the "extract" and
# "build" stages, inclusive). The test done to
# determine the existence of the dependency is the
# same as FETCH_DEPENDS. If the third field ("target")
# exists, it will be used instead of ${DEPENDS_TARGET}.
# RUN_DEPENDS - A list of "path:dir[:target]" tuples of other ports this
# package depends to run. The test done to determine
# the existence of the dependency is the same as
# FETCH_DEPENDS. This will be checked during the
# "install" stage and the name of the dependency will
# be put into the package as well. If the third field
# ("target") exists, it will be used instead of
# ${DEPENDS_TARGET}. The first field also supports a
# package name with a version range, in the form package>=1.2
# if a particular version is desired.
# LIB_DEPENDS - A list of "lib:dir[:target]" tuples of other ports this
# package depends on. "lib" is the name of a shared library.
# TEST_DEPENDS - A list of "path:dir[:target]" tuples of other ports this
# package depends on in the "test" stage. "path" is the
# name of a file if it starts with a slash (/), an
# executable otherwise. make will test for the existence
# (if it is a full pathname) or search for it in your
# $PATH (if it is an executable) and go into "dir" to do
# a "make all install" if it's not found. If the third
# field ("target") exists, it will be used instead of
# ${DEPENDS_TARGET}. The first field also supports a
# package name with a version range, in the form package>=1.2
# if a particular version is desired.
# DEPENDS_TARGET
# - The default target to execute when a port is calling a
# dependency.
# Default: install
#
# These variables control options about how a port gets built and/or
# are shorthand notations for common sets of dependencies.
# Use these if your port uses some of the common software packages. By
# convention these should be set to 'yes', although they only need to be
# defined. Defaults: not set, unless explicitly indicated below.
#
# Note: the distinction between the USE_* and WANT_* variables, and the
# WITH_* and WITHOUT_* variables, are that the former are restricted to
# usage inside the ports framework, and the latter are reserved for user-
# settable options. (Setting USE_* in /etc/make.conf is always wrong).
#
# WITH_DEBUG - If set, debugging flags are added to CFLAGS and the
# binaries don't get stripped by INSTALL_PROGRAM or
# INSTALL_LIB. Besides, individual ports might
# add their specific to produce binaries for debugging
# purposes. You can override the debug flags that are
# passed to the compiler by setting DEBUG_FLAGS. It is
# set to "-g" at default.
#
# NOTE: to override a globally defined WITH_DEBUG at a
# later time ".undef WITH_DEBUG" can be used
#
# WITH_DEBUG_PORTS - A list of origins for which WITH_DEBUG will be set
#
# WITHOUT_SSP - Disable SSP.
#
# SSP_CFLAGS - Defaults to -fstack-protector. This value
# is added to CFLAGS and the necessary flags
# are added to LDFLAGS. Note that SSP_UNSAFE
# can be used in Makefiles by port maintainers
# if a port breaks with it (it should be
# extremely rare).
##
# USE_LOCALE - LANG and LC_ALL are set to the value of this variable in
# CONFIGURE_ENV and MAKE_ENV. Example: USE_LOCALE=en_US.UTF-8
##
# USE_GCC - If set, this port requires this version of gcc, either in
# the system or installed from a port.
# USE_CSTD - Override the default C language standard (gnu89, gnu99)
# USE_CXXSTD Override the default C++ language standard
# USE_BINUTILS - Use binutils suite from port instead of the version in base.
# CFLAGS_${ARCH} Append the cflags to CFLAGS only on the specified architecture
# CXXFLAGS_${ARCH}
# Append the cxxflags to CXXFLAGS only on the specified architecture
##
# LDFLAGS_${ARCH} Append the ldflags to LDFLAGS only on the specified architecture
##
# USE_OPENLDAP - If set, this port uses the OpenLDAP libraries.
# Implies: WANT_OPENLDAP_VER?=24
# WANT_OPENLDAP_VER
# - Legal values are: 23, 24
# If set to an unknown value, the port is marked BROKEN.
# WANT_OPENLDAP_SASL
# - If set, the system should use OpenLDAP libraries
# with SASL support.
##
# USE_JAVA - If set, this port relies on the Java language.
# Implies inclusion of bsd.java.mk. (Also see
# that file for more information on USE_JAVA_*).
# USE_OCAML - If set, this port relies on the OCaml language.
# Implies inclusion of bsd.ocaml.mk. (Also see
# that file for more information on USE_OCAML*).
# USE_RUBY - If set, this port relies on the Ruby language.
# Implies inclusion of bsd.ruby.mk. (Also see
# that file for more information on USE_RUBY_*).
##
# USE_GECKO - If set, this port uses the Gecko/Mozilla product.
# See bsd.gecko.mk for more details.
##
# USE_WX - If set, this port uses the WxWidgets library and related
# components. See bsd.wx.mk for more details.
##
# USE_LINUX_PREFIX
# - Controls the action of PREFIX (see above). Only use this
# if the port is a Linux infrastructure port (e.g. contains libs
# or a sound server which supports the FreeBSD native one),
# use the default prefix if it's a leaf port (e.g. a game or
# program).
# Implies NO_LICENSES_INSTALL=yes, NO_MTREE=yes, and causes
# Linux ldconfig to be used when USE_LDCONFIG is defined.
##
# USE_TEX - A list of the TeX dependencies the port has.
#
##
# USE_RC_SUBR - If set, the ports startup/shutdown script uses the common
# routines found in /etc/rc.subr.
# If this is set to a list of files, these files will be
# automatically added to ${SUB_FILES}, some %%VAR%%'s will
# automatically be expanded, they will be installed in
# ${PREFIX}/etc/rc.d if ${PREFIX} is not /usr, otherwise they
# will be installed in /etc/rc.d/ and added to the packing list.
##
# Conflict checking. Use if your port cannot be installed at the same time as
# another package.
#
# CONFLICTS - A list of package name patterns that the port conflicts
# with, separated by blanks. The names may include shell
# pattern meta-characters "*", "?", "[", "]", and "!".
# Example: apache*-1.2* apache*-1.3.[012345] apache-*+ssl_*
#
# CONFLICTS_BUILD
# - Check conflict prior to the build.
#
# CONFLICTS_INSTALL
# - Check conflict prior to the installation stage.
#
# Various directory definitions and variables to control them.
# You rarely need to redefine any of these except WRKSRC and NO_WRKSUBDIR.
#
# LOCALBASE - Where ports install things.
# Default: /usr/local
# LINUXBASE - Where Linux ports install things.
# Default: /compat/linux
# PREFIX - Where *this* port installs its files.
# Default: ${LINUXBASE} if USE_LINUX_PREFIX is set,
# otherwise ${LOCALBASE}
#
# IGNORE_PATH_CHECKS
# - There are some sanity checks against PREFIX.
# You can disable these checks with defining
# this variable, but this is not recommended!
# Only do this if you really know what you are
# doing. These sanity checks are the following:
# - PREFIX has to be an absolute path.
# - PREFIX can't have a trailing slash.
#
# BUNDLE_LIBS Teach pkg(8) to not automatically add all shared libraries
# installed by a port as shared libraries "provided" for
# other packages (i.e., do not expose them in the solver).
# This has to be used for ports that bundle third party
# libraries for internal usage.
# MASTERDIR - Where the port finds patches, package files, etc. Define
# this is you have two or more ports that share most of the
# files.
# Default: ${.CURDIR}
# PORTSDIR - The root of the ports tree.
# Default: /usr/ports
# DISTDIR - Where to search for and store copies of original sources
# Default: ${PORTSDIR}/distfiles
# PACKAGES - A top level directory where all packages go (rather than
# going locally to each port).
# Default: ${PORTSDIR}/packages
# WRKDIRPREFIX - The place to root the temporary working directory
# hierarchy. This path must *not* end in '/'.
# Default: none
# WRKDIR - A temporary working directory that gets *clobbered* on clean
# Default: ${WRKDIRPREFIX}${.CURDIR}/work
# WRKSRC - A subdirectory of ${WRKDIR} where the distribution actually
# unpacks to.
# Default: ${WRKDIR}/${DISTNAME}
# WRKSRC_SUBDIR - A subdirectory of ${WRKSRC} where the distribution actually
# builds in.
# Default: not set
# NO_WRKSUBDIR - Assume port unpacks without a subdirectory, and extract it in
# ${WRKSRC} instead of ${WRKDIR}.
# PATCHDIR - A directory containing any additional patches you made
# to port this software to FreeBSD.
# Default: ${MASTERDIR}/files
# SCRIPTDIR - A directory containing any auxiliary scripts
# Default: ${MASTERDIR}/scripts
# FILESDIR - A directory containing any miscellaneous additional files.
# Default: ${MASTERDIR}/files
# PKGDIR - A directory containing any package creation files.
# Default: ${MASTERDIR}
# SRC_BASE - The root of the src tree. (Some ports require this to get
# kernel sources). Default: /usr/src
# UID_FILES - A list of files containing information about registered UIDs.
# Note that files have decreasing priority.
# GID_FILES - A list of files containing information about registered GIDs.
# Note that files have decreasing priority.
#
# Variables that serve as convenient "aliases" for your *-install targets.
# Use these like: "${INSTALL_PROGRAM} ${WRKSRC}/prog ${PREFIX}/bin".
#
# INSTALL_PROGRAM
# - A command to install binary executables. (By
# default, also strips them, unless ${STRIP} is
# overridden to be the empty string).
# INSTALL_KLD - As INSTALL_PROGRAM, but without the STRIP.
# INSTALL_LIB - As INSTALL_DATA, but also strips the file.
# INSTALL_SCRIPT
# - A command to install executable scripts.
# INSTALL_DATA - A command to install sharable data and static libs.
# INSTALL_MAN - A command to install manpages and documentation.
# COPYTREE_BIN
# COPYTREE_SHARE
# - Similiar to INSTALL_PROGRAM and INSTALL_DATA commands but
# working on whole trees of directories, takes 3 arguments,
# last one is find(1) arguments and optional.
# Example use:
# cd ${WRKSRC}/doc && ${COPYTREE_SHARE} . ${DOCSDIR} "! -name *\.bak"
#
# Installs all directories and files from ${WRKSRC}/doc
# to ${DOCSDIR} except sed(1) backup files.
#
# MANPREFIX - The directory prefix for manual pages.
# Default: ${PREFIX}
# MAN<sect>PREFIX
# - If manual pages of some sections install in different
# locations than others, use these.
# Default: ${MANPREFIX}
#
# Set the following to specify all .info files your port installs.
#
# INFO - A list of .info files (omitting the trailing ".info");
# only one entry per document! These files are listed in
# the path relative to ${INFO_PATH}.
# INFO_PATH - Path, where all .info files will be installed by your
# port, relative to ${PREFIX}
#
# Set the following to specify all documentation your port installs into
# ${DOCSDIR}
#
# PORTDOCS - A list of files and directories relative to DOCSDIR.
# Shell glob patterns can be used, directories include
# the entire subtree of contained files and directories.
# Should not be set when no documentation files are
# installed.
# Useful for dynamically generated documentation.
#
# Set the following to specify all documentation your port installs into
# ${EXAMPLESDIR}
#
# PORTEXAMPLES - A list of files and directories relative to EXAMPLESDIR.
# Shell glob patterns can be used, directories include
# the entire subtree of contained files and directories.
# Should not be set when no examples files are
# installed.
# Useful for dynamically generated examples.
#
# Set the following to specify all files and directories your port installs into
# ${DATADIR}
#
# PORTDATA - A list of files and directories relative to DATADIR.
# Shell glob patterns can be used, directories include
# the entire subtree of contained files and directories.
# Should not be set when no data files are
# installed.
# Useful for dynamically generated data files.
#
# Default targets and their behaviors:
#
# fetch - Retrieves missing ${DISTFILES} and ${PATCHFILES} for this
# port.
# fetch-list - Show list of commands to retrieve missing ${DISTFILES} and
# ${PATCHFILES} for this port.
# fetch-recursive
# - Retrieves missing ${DISTFILES} and ${PATCHFILES} for this
# port and dependencies.
# fetch-recursive-list
# - Show list of commands to retrieve missing ${DISTFILES} and
# ${PATCHFILES} for this port and dependencies.
# fetch-required
# - Retrieves missing ${DISTFILES} and ${PATCHFILES} for this
# port and dependencies.
# fetch-required-list
# - Show list of commands to retrieve missing ${DISTFILES} and
# ${PATCHFILES} for this port and dependencies.
# fetch-url-list
# - Show list of URLS to retrieve missing ${DISTFILES} and
# ${PATCHFILES} for this port.
# fetch-urlall-list
# - Show list of URLS to retrieve ${DISTFILES} and
# ${PATCHFILES} for this port.
#
# all-depends-list
# - Show all directories which are dependencies
# for this port.
# build-depends-list
# - Show all directories which are build-dependencies
# for this port.
# package-depends-list
# - Show all directories which are package-dependencies
# for this port. This is based upon the dependency
# tree as recorded in the Makefiles of the ports
# collection, not as recorded in the currently
# installed ports.
# actual-package-depends
# - Like package-depends-list but with the difference
# that the dependencies of the currently installed
# ports are used instead of the dependencies as
# recorded in the ports collection.
# run-depends-list
# - Show all directories which are run-dependencies
# for this port.
# test-depends-list
# - Show all directories which are test-dependencies
# for this port.
# install-missing-packages
# - Install missing dependencies from package and mark
# them as automatically installed.
# extract - Unpacks ${DISTFILES} into ${WRKDIR}.
# patch - Apply any provided patches to the source.
# configure - Runs either GNU configure, one or more local configure
# scripts or nothing, depending on what's available.
# build - Actually compile the sources.
# install - Install the results of a build.
# reinstall - Install the results of a build, deinstalling any previous
# installation if needed.
# deinstall - Remove the installation.
# deinstall-all - Remove all installations with the same PKGORIGIN.
# test - Run tests for the port.
# package - Create a package from an _installed_ port.
# package-recursive
# - Create a package for a port and _all_ of its dependencies.
# describe - Try to generate a one-line description for each port for
# use in INDEX files and the like.
# check-plist - Checks for files missing from the plist, and files in the plist
# that are not installed by the port.
# check-sanity - Perform some basic checks of the port layout.
# checkpatch - Do a "patch -C" instead of a "patch". Note that it may
# give incorrect results if multiple patches deal with
# the same file.
# checksum - Use distinfo to ensure that your distfiles are valid.
# checksum-recursive
# - Run checksum in this port and all dependencies.
# makesum - Generate distinfo (only do this for your own ports!).
# clean - Remove ${WRKDIR} and other temporary files used for building.
# clean-depends - Do a "make clean" for all dependencies.
# config - Configure options for this port (using ${DIALOG}).
# Automatically run prior to extract, patch, configure, build,
# install, and package.
# config-recursive
# - Configure options for this port for a port and all its
# dependencies.
# showconfig - Display options config for this port.
# showconfig-recursive
# - Display options config for this port and all its
# dependencies.
# rmconfig - Remove the options config for this port.
# rmconfig-recursive
# - Remove the options config for this port and all its
# dependencies.
#
# Default sequence for "all" is:
#
# check-sanity fetch checksum extract patch configure build
#
# Please read the comments in the targets section below; you
# should be able to use the pre-* or post-* targets/scripts
# (which are available for every stage except checksum) or
# override the do-* targets to do pretty much anything you want.
#
# The TARGET_ORDER_OVERRIDE variable can be set to multiple <priority>:<target>
# to change the ordering of targets, have a look at the _SEQ variables at the
# end of this file for the default order and priorities.
#
# NEVER override the "regular" targets unless you want to open
# a major can of worms.
#
# Set these variables if your port doesn't need some of the steps.
# Note that there are no NO_PATCH or NO_CONFIGURE variables because
# those steps are empty by default. NO_EXTRACT is not allowed anymore
# since we need to at least create ${WRKDIR}. Also, NO_CHECKSUM is a user
# variable and is not to be set in a port's Makefile. See above for NO_PACKAGE.
#
# NO_BUILD - Use a dummy (do-nothing) build target.
# NO_INSTALL - Use a dummy (do-nothing) install target.
# NO_TEST - Use a dummy (do-nothing) test target.
#
# Here are some variables used in various stages.
#
# For options see bsd.options.mk
#
# For fetch:
#
# FETCH_BINARY - Path to ftp/http fetch command if not in $PATH.
# Default: "/usr/bin/fetch"
# FETCH_ARGS - Arguments to ftp/http fetch command.
# Default: "-Fpr"
# FETCH_CMD - ftp/http fetch command.
# Default: ${FETCH_BINARY} ${FETCH_ARGS}
# FETCH_BEFORE_ARGS
# - Arguments to ${FETCH_CMD} before filename.
# Default: none
# FETCH_AFTER_ARGS
# - Arguments to ${FETCH_CMD} following filename.
# Default: none
# FETCH_ENV - Environment to pass to ${FETCH_CMD}.
# Default: none
# FETCH_REGET - Times to retry fetching of files on checksum errors.
# Default: 1
# CLEAN_FETCH_ENV
# - Disable package dependency in fetch target for mass
# fetching. User settable.
#
# For extract:
#
# EXTRACT_CMD - Command for extracting archive
# Default: ${TAR}
# EXTRACT_BEFORE_ARGS
# - Arguments to ${EXTRACT_CMD} before filename.
# Default: "-xf"
# EXTRACT_AFTER_ARGS
# - Arguments to ${EXTRACT_CMD} following filename.
# Default: "--no-same-owner --no-same-permissions"
# For patch:
#
# EXTRA_PATCHES - Define this variable if you have patches not in
# ${PATCHDIR}. This usually happens when you need to
# do some pre-processing before some distribution
# patches can be applied. In that case, fetch them as
# extra distfiles, put the processed results in
# ${WRKDIR}, then point EXTRA_PATCHES to them.
# The patches specified by this variable will be
# applied after the normal distribution patches but
# before those in ${PATCHDIR}. This can also contain
# directories, all the files named patch-* in those directories
# will be applied.
# EXTRA_PATCH_TREE - where to find extra 'out-of-tree' patches
# Points to a directory hierarchy with the same layout
# as the ports tree, where local patches can be found.
# This allows a third party to keep their patches in
# some other source control system if needed.
# PATCH_WRKSRC - Directory to apply patches in.
# Default: ${WRKSRC}
#
# For configure:
#
# HAS_CONFIGURE - If set, this port has its own configure script. The
# configure stage will not do anything if this is not set.
# GNU_CONFIGURE - If set, you are using GNU configure (optional). Implies
# HAS_CONFIGURE.
# CONFIGURE_OUTSOURCE - If set, this port builds in an empty ${CONFIGURE_WRKSRC}
# not being under ${WRKSRC}.
# CONFIGURE_WRKSRC
# - Directory to run configure in.
# Default: ${WRKSRC}
# CONFIGURE_SCRIPT
# - Name of configure script, relative to ${CONFIGURE_WRKSRC}.
# Default: "Makefile.PL" if USES=perl5 and USE_PERL5=configure
# are set, "configure" otherwise.
# CONFIGURE_TARGET
# - The name of target to call when GNU_CONFIGURE is
# defined.
# Default: ${ARCH}-portbld-${OPSYS:tl}${OSREL}
# GNU_CONFIGURE_PREFIX
# - The directory passed as prefix to the configure script if
# GNU_CONFIGURE is set.
# Default: ${PREFIX}
# CONFIGURE_ARGS
# - Pass these args to configure if ${HAS_CONFIGURE} is set.
# Default: "--prefix=${GNU_CONFIGURE_PREFIX}
# --infodir=${PREFIX}/${INFO_PATH} --localstatedir=/var
# --mandir=${MANPREFIX}/man --build=${CONFIGURE_TARGET}" if
# GNU_CONFIGURE is set, "CC=${CC} CFLAGS=${CFLAGS}
# PREFIX=${PREFIX} INSTALLPRIVLIB=${PREFIX}/lib
# INSTALLARCHLIB=${PREFIX}/lib" if USES=perl5 and
# USE_PERL5=configure are set, empty otherwise.
# CONFIGURE_ENV - Pass these env (shell-like) to configure if
# ${HAS_CONFIGURE} is set.
# CONFIGURE_LOG - The name of configure log file. It will be printed to
# the screen if configure fails.
# Default: config.log
# CONFIGURE_FAIL_MESSAGE
# - A message displayed to users when configure
# fails (note: this assumes the do-configure
# target has not been overwritten). This message
# will be passed through /usr/bin/fmt before
# being shown to the user.
#
# WITHOUT_FBSD10_FIX Disable FreeBSD 10.0 autotools workaround.
#
# For build and install:
#
# MAKEFILE - Name of the makefile.
# Default: Makefile
# ALL_TARGET - Default target for sub-make in build stage.
# Default: all
# BUILD_WRKSRC - Directory to do build in (default: ${WRKSRC}).
# MAKE_ENV - Additional environment vars passed to sub-make in build
# and install stages.
# Default: see below
# MAKE_ARGS - Any extra arguments to sub-make in build and install stages.
# Default: none
##
# MAKE_JOBS_UNSAFE
# - Disallow multiple jobs even when user set a global override.
# To be used with known bad ports.
# DISABLE_MAKE_JOBS
# - Set to disable the multiple jobs feature. User settable.
# MAKE_JOBS_NUMBER
# - Override the number of make jobs to be used. User settable.
# MAKE_JOBS_NUMBER_LIMIT
# - Set a limit for maximum number of make jobs allowed to be
# used.
## ccache
#
# WITH_CCACHE_BUILD
# - Enable CCACHE support (devel/ccache). User settable.
# CCACHE_DIR
# - Which directory to use for ccache (default: $HOME/.ccache)
# NO_CCACHE
# - Disable CCACHE support for example for certain ports if
# CCACHE is enabled. User settable.
#
# For test:
#
# TEST_TARGET - Target for sub-make in test stage. If not defined,
# no default test target is provided.
# Default: (none)
# TEST_WRKSRC - Directory to do test in (default: ${WRKSRC}).
# TEST_ENV - Additional environment vars passed to sub-make in test
# stage
# Default: ${MAKE_ENV}
# TEST_ARGS - Any extra arguments to sub-make in test stage
# Default: ${MAKE_ARGS}
#
# For install:
#
# INSTALL_TARGET
# - Default target for sub-make in install stage.
# Default: install
# INSTALL_WRKSRC
# - Directory to install from
# Default: ${WRKSRC}
# NO_MTREE - If set, will not invoke mtree from bsd.port.mk from
# the "install" target.
# MTREE_FILE - The name of the mtree file.
# Default: ${PORTSDIR}/Templates/BSD.local.dist or
# /etc/mtree/BSD.usr.dist if ${PREFIX} == "/usr".
# PLIST_DIRS - Directories to be added to packing list
# PLIST_FILES - Files and symbolic links to be added to packing list
#
# PLIST - Name of the `packing list' file.
# Change this to ${WRKDIR}/PLIST or something if you
# need to write to it. (It is not a good idea for a port
# to write to any file outside ${WRKDIR} during a normal
# build.)
# Default: ${PKGDIR}/pkg-plist
# TMPPLIST - Name of the `packing list' file after processing
# Default: ${WRKDIR}/.PLIST.mktmp
# PLIST_SUB - List of "variable=value" pair for substitution in ${PLIST}
# Default: see below
#
# SUB_FILES - Files that should be passed through sed(1) and redirected to
# ${WRKDIR}.
# - For each file specified in SUB_FILES, there must be a
# corresponding file in ${FILESDIR} whose suffix is ".in". For
# instance, if the Makefile specifies "SUB_FILES= pkg-message"
# then there must be a file called pkg-message.in in
# ${FILESDIR}.
# - The substitution process is the same as PLIST_FILES, as
# described below except that any line beginning with @comment
# is deleted.
# SUB_LIST - List of "variable=value" pair for substitution in ${SUB_FILES}
# Some pairs are added by default: eg. PREFIX=${PREFIX}
#
# USE_LDCONFIG - If set to "yes", this adds ${PREFIX}/lib to the list of
# directories to be searched for shared libraries.
# Otherwise, this is a list of directories to be added to that
# list. The directory names are written to
# ${LOCALBASE}/libdata/ldconfig/${PKGBASE} which is then
# used by the ldconfig startup script.
# This mechanism replaces ldconfig scripts installed by some
# ports, often under such names as 000.${UNQUENAME}.sh.
# If USE_LINUX_PREFIX is defined, the Linux version of
# ldconfig will be used instead of the native FreeBSD
# version, and the directory list given will be ignored.
# USE_LDCONFIG32
# - Same as USE_LDCONFIG but the target file is
# ${LOCALBASE}/libdata/ldconfig32/${PKGBASE} instead.
# Note: that should only be used on 64-bit architectures.
#
# DOCSDIR - Name of the directory to install the packages docs in.
# Default: ${PREFIX}/share/doc/${PORTNAME}
# DOCSDIR_REL - The DOCSDIR relative to ${PREFIX}
# EXAMPLESDIR - Name of the directory to install the packages examples in.
# Default: ${PREFIX}/share/examples/${PORTNAME}
# EXAMPLESDIR_REL
# - The EXAMPLESDIR relative to ${PREFIX}
# DATADIR - Name of the directory to install the packages shared data in.
# Default: ${PREFIX}/share/${PORTNAME}
# DATADIR_REL - The DATADIR relative to ${PREFIX}
#
# WWWDIR - Name of the directory to install the packages www data in.
# Default: ${PREFIX}/www/${PORTNAME}
# WWWDIR_REL - The WWWDIR relative to ${PREFIX}
#
# USERS - List of users to create at install time. Each login must
# have a corresponding entry in ${UID_FILES}.
# GROUPS - List of groups to create at install time. Each group must
# have a corresponding entry in ${GID_FILES}.
#
# DESKTOPDIR - Name of the directory to install ${DESKTOP_ENTRIES} in.
# Default: ${PREFIX}/share/applications
# DESKTOP_ENTRIES
# - List of desktop entry files to generate and install in
# ${DESKTOPDIR}. The format is
# "Name" "Comment" "Icon" "Exec" "Categories" StartupNotify
# Rules:
# * Only add desktop entries for applications which do not
# require a terminal (ie. X applications).
# * If the upstream distribution already installs .desktop
# files, you do not need to use this.
# * If you require a more elaborate .desktop file than this
# variable permits, write it yourself and install it
# in ${DESKTOPDIR}.
# Notes:
# * Comment, Icon and StartupNotify may be empty
# strings (""). Categories may be an empty string in some
# cases (see below). The other fields are mandatory.
# * If Comment is an empty string, port ${COMMENT} will be
# used.
# * If set, Icon must be either absolute path (usually
# ${PREFIX}/share/pixmaps/${PORTNAME}.png) or icon name
# without extension if installed icons follow Icon Theme
# Specification.
# * If Categories is an empty string, bsd.port.mk will try
# to deduce a default value using the CATEGORIES variable.
# If the deduction fails, you will have to set Categories
# manually. You should check the generated value using
# "make desktop-categories", and override it if necessary.
# * Exec will also be used to name the .desktop file.
# * StartupNotify may be true, false or empty (see Desktop
# Entry Specification for details).
# * The files will be automatically added to ${PLIST}.
# Example:
# "X Window Information" \
# "Get information about X windows" \
# "${PREFIX}/share/pixmaps/wininfo.png" \
# "${PREFIX}/bin/wininfo" \
# "System;" \
# ""
# See http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html
# for an explanation of the fields. If you need to create more
# than one file, just chain them into a single variable.
#
# Note that the install target will automatically add manpages (see
# above) and also substitute special sequences of characters (delimited
# by "%%") as defined in PLIST_SUB to generate ${TMPPLIST}. For
# instance, "OSREL=${OSREL}" in PLIST_SUB causes all occurrences of
# "%%OSREL%%" in ${PLIST} to be substituted by the value of OSREL.
# ${TMPPLIST} is generated before the do-install stage. If you are
# generating the packing list on-the-fly, make sure it's generated before
# do-install is called!
#
# This is used in all stages:
#
# SCRIPTS_ENV - Additional environment vars passed to scripts in
# ${SCRIPTDIR} executed by bsd.port.mk.
# Default: see below
#
# Finally, variables to change if you want a special behavior. These
# are for debugging purposes. Don't set them in your Makefile.
#
# ECHO_MSG - Used to print all the '===>' style prompts - override this
# to turn them off.
# Default: ${ECHO_CMD}
# PATCH_DEBUG - If set, print out more information about the patches as
# it attempts to apply them.
# PKG_DBDIR - Where package installation is recorded; this directory
# must not contain anything else.
# Default: /var/db/pkg
# PORT_DBDIR - Where port configuration options are recorded.
# Default: /var/db/ports
# NO_PKG_REGISTER
# - Don't register a port installation as a package.
# FORCE_PKG_REGISTER
# - If set, it will overwrite any existing package
# registration information in ${PKG_DBDIR}/${PKGNAME}.
# NO_DEPENDS - Don't verify build of dependencies.
# STRICT_DEPENDS
# - Verify dependencies but consider missing dependencies as
# fatal.
# CHECKSUM_ALGORITHMS
# - Different checksum algorithms to check for verifying the
# integrity of the distfiles. The absence of the algorithm
# in distinfo doesn't make it fail.
# Default: sha256
# NO_CHECKSUM - Don't verify the checksum. Typically used when
# when you noticed the distfile you just fetched has
# a different checksum and you intend to verify if
# the port still works with it.
# USE_PACKAGE_DEPENDS
# - Try to install dependencies from existing packages instead
# of building the port from scratch. Fallback on source
# if an existing package is not present.
# USE_PACKAGE_DEPENDS_ONLY
# - Like USE_PACKAGE_DEPENDS, but do not fallback on source.
# INSTALL_AS_USER
# - Define this to install as the current user, intended
# for systems where you have no root access.
# DISABLE_SIZE - Do not check the size of a distfile even if the SIZE field