summaryrefslogtreecommitdiffstats
path: root/specs/spf-2.0/fields.mdwn
blob: 51a9415f40043707543c2b264e1c97efa97e810e (plain)
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
Source Package Fields [fields-src]
==================================

The fields in the source package metadata are:

  * `Maintainer` (required)  

    The name and e-mail address of the package maintainer.  This field must
    follow the syntax of the `mailbox` symbol in RFC 5322 section 3.4.

  * `Build-Depends` (optional)  

    A list of packages that must be installed before the package can be built.

  * `Homepage` (optional)  

    The URL of the Web site for the package.  Accessible at this site should be
    origin source code and documentation and/or information.  Though the
    information in this field is machine-usable, the URL must not be surrounded
    by angle brackets or any other characters.


Binary Package Fields [fields-bin]
==================================

The fields in the binary package metadata are:

  * `Architecture` (required)  

    A list of architectures for which this package may be built.  The value may
    be any one of the following:

    - The string `all` to specify that all of the provided files are
      architecture-independent;
    - The string `any` to specify that at least some of the provided files are
      architecture-dependent; or
    - A space-separated list of one or more real or wildcard binary architecture
      strings to specify that at least some of the provided files are only
      usable on systems of the named binary architecture(s).

    A "wildcard" binary architecture string is one in which one or two
    components (called "wildcard components") is the string `any`.  It shall be
    considered to match any real binary architecture string for which the
    non-wildcard components are equal.

  * `Platform` (required)

    A list of platforms for which this package may be built.  The value may be
    any one of the following:

    - The string `all` to specify that all of the provided files are
      platform-independent;
    - The string `any` to specify that at least some of the provided files are
      platform-dependent; or
    - A space-separated list of one or more platform strings to specify that at
      least some of the provided files are only usable on systems of the named
      platform(s).

  * `Essential` (optional)  

    A flag to indicate whether the package is essential for the functioning of a
    system on which it is installed.  If this field is set to `yes`, opkg will
    refuse to remove the package except when upgrading it.  If this field is set
    to any other value or is omitted, the package may be removed by a user.

  * `Depends` (optional)  

    A list of packages that must be installed and configured before the package
    may itself be configured.

  * `Recommends` (optional)  

  * `Suggests` (optional)  

  * `Pre-Depends` (optional)  

    A list of packages that must be installed before the package may itself be
    installed.

  * `Conflicts` (optional)  

  * `Provides` (optional)  

  * `Replaces` (optional)  

  * `Description` (required)  

    A description of the binary package.  This is a multiline field.  The first
    line is a short synopsis, and all following lines are an extended
    description.