doc/multi-platform.txt
author Edward Pilatowicz <edward.pilatowicz@oracle.com>
Mon, 16 Sep 2013 21:26:31 -0700
changeset 2945 24196b483cc6
parent 804 25e52022014d
permissions -rw-r--r--
17461187 packagemanager displays unexpected error message
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
109
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
     1
pkg
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
     2
MULTI-PLATFORM
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
     3
804
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
     4
The core pkg(5) technology is generic enough to be useful across multiple platforms
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
     5
(e.g. Windows and Linux). The full range of supported platforms are listed here:
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
     6
http://wikis.sun.com/display/IpsBestPractices/OS+Platform+Support
109
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
     7
804
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
     8
The following modules within the pkg(5) source base are multi-platform:
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
     9
    - the CLIs (client.py, publish.py, depot.py, pull.py)
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    10
    - src/modules (the core of pkg(5))
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    11
    - src/tests (except the CLI tests do not run on Windows)
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    12
    - src/man
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    13
    - src/web
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    14
    - src/po (except for the GUI messages which are OpenSolaris-only)
109
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
    15
804
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    16
The following modules are not multi-platform (only supported on OpenSolaris):
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    17
    - src/brand
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    18
    - src/gui, src/um and the start scripts (packagemanger.py, updatemanager.py,
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    19
        and updatemanagernotifier.py)
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    20
    - pkgdefs
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    21
    - SMF support: src/svc-pkg-depot, src/pkg-server.xml, src/pkg-update.xml
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    22
    - src/util
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    23
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    24
The following modules are only used for non-OpenSolaris support:
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    25
    - src/scripts
109
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
    26
804
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    27
Multi-platform support is focused on providing support for user images as the 
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    28
operating system software is not delivered for other platforms using pkg(5).
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    29
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    30
Development best practices for writing multi-platform pkg(5) code are available
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    31
here: http://opensolaris.org/os/project/pkg/devinfo/bestpractices/.
109
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
    32
804
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    33
Build instructions for non-OpenSolaris platforms are here:
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    34
http://wiki.updatecenter.java.net/Wiki.jsp?page=IPSHOWTO
109
228336c1a183 Add notes around multi-platform porting effort, starting with Linux
James Falkner <james.falkner@sun.com>
parents:
diff changeset
    35
804
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    36
Information about using multi-platform pkg(5) and pre-built binaries
25e52022014d 3263 update multi-platform.txt document
Tom Mueller <Tom.Mueller@sun.com>
parents: 109
diff changeset
    37
are available here: http://wikis.sun.com/display/IpsBestPractices