lsbom(8) [mojave man page]
LSBOM(8) BSD System Manager's Manual LSBOM(8) NAME
lsbom -- list contents of a bom file SYNOPSIS
lsbom [-b] [-c] [-d] [-f] [-l] [-m] [-s] [-x] [--arch archVal] [-p parameters] bom ... lsbom -h | --help DESCRIPTION
The lsbom command interprets the contents of binary bom (bom(5)) files. For each file in a bom, lsbom prints the file path and/or requested information. If no options are given, lsbom will display the output formatted such that each line contains the path of the entry, its mode (octal), and its UID/GID. There are slight differences in the output for plain files, directories, symbolic links, and device files as follows: plain files the UID/GID is followed by the file size and a 32-bit CRC checksum of the file's contents. symbolic links the UID/GID is followed by the size and checksum of the link path, and the link path itself. device files the UID/GID file number is followed by the device number. The -p option can be used to specify a user-defined format for lsbom's output. The format string consists of one or more characters described below where each character represents a data type. Data types will be separated by tab characters, and each line will end with a newline character. One can use this mechanism to create output similar to the ls(1) command. The options are: -h print full usage -b list block devices -c list character devices -d list directories -f list files -l list symbolic links -m print modified times (for plain files only) -s print only the path of each file -x suppress modes for directories and symlinks --arch archVal when displaying plain files that represent Universal Mach-O binaries, print the size and checksum of the file contents for the specified archVal (either "ppc", "ppc64", or "i386") -p parameters print only some of the results Note: each option can only be used once: c 32-bit checksum f file name F file name with quotes (i.e. "/mach_kernel") g group id G group name m file mode (permissions) M symbolic file mode (i.e. "dr-xr-xr-x" ) s file size S formatted size t mod time T formatted mod time u user id U user name / user id/group id ? user name/group name EXAMPLES
lsbom bomfile list the contents of bomfile lsbom -s bomfile list only the paths of the contents of the bomfile lsbom -f -l bomfile list the plain files and symbolic links of the bomfiles (but not directories or devices) lsbom -p MUGsf bomfiles list the contents of bomfile displaying only the files' modes, user name, group name, size, and filename SEE ALSO
bom(5), ditto(8), mkbom(8), pkgutil(1) HISTORY
The lsbom command appeared in NeXTSTEP as a tool to browse the contents of bom files used during installation. The -p flag appeared in Mac OS X 10.1 in an attempt to make lsbom's output more convenient for human beings. Mac OS X May 7, 2008 Mac OS X
Check Out this Related Man Page
pkgutil(1) BSD General Commands Manual pkgutil(1) NAME
pkgutil -- Query and manipulate Mac OS X Installer packages and receipts. SYNOPSIS
pkgutil [options] [commands] DESCRIPTION
pkgutil reads and manipulates Mac OS X Installer flat packages, and provides access to the ``receipt'' database used by the Installer. Options are processed first, and affect the operation of all commands. Multiple commands are performed sequentially in the given order. The files and directories where receipts are stored are subject to change. Always use pkgutil to query or modify them. OPTIONS
--help, -h A brief summary of commands and usage. --force, -f Don't ask for confirmation before performing a potentially destructive or ambiguous operation. --verbose, -v Output in a "human-readable" format with extra headers, footers, indentation, and other contextual information. --volume path Perform all operations on the specified volume or home directory. The root volume '/' will be used if unspecified. --edit-pkg package-id Specifies an existing receipt to be modified in-place by --learn. --only-files List only files (not directories) in --files listing. --only-dirs List only directories (not files) in --files listing. --regexp Try to match package-id arguments as a regular expression if an exact match isn't found. See egrep(1) and re_format(7) for syn- tax. RECEIPT DATABASE COMMANDS
--packages, --pkgs List all installed package IDs on the specified --volume. --pkgs-plist List all installed package IDs on the specified --volume in Mac OS X plist(5) format. --pkgs=REGEXP List all installed package IDs matching REGEXP on the specified --volume. The equal sign (=) is required or the search string will be ignored and all package IDs will be returned. Be mindful of escaping characters in both your shell and the regular expression. (Eg, 'pkgutil --pkgs=\.D' searches for package IDs matching the literal '.D' after escaping the backslash from your shell and then the dot from the regex to make it literal.) Regular expressions are more complex than simple shell globbing. A dot (.) matches any character, while '*' matches zero or more of the previous character. See re_format(7) for a complete description of the syntax. --files package-id List all of the files installed under the package-id. --export-plist package-id Print all receipt information about the specified package-id in the standard Mac OS X plist(5) format. --pkg-info package-id Print extended information about the specified package-id. --pkg-info-plist package-id Print extended information about the specified package-id in Mac OS X plist(5) format. --forget package-id Discard all receipt data about package-id, but do not touch the installed files. DO NOT use this command from an installer pack- age script to fix broken package design. --learn path Update the ACLs of the given path in the receipt identified by --edit-pkg. This affects subsequent repair operations on the package. This command cannot be used from package postinstall scripts, but if a postinstall script changes the ACLs on the installed files, the receipt is automatically be updated to reflect those changes. This command will not update the filesystem permissions in the receipt. --pkg-groups package-id List all of the package groups this package-id is a member of. --groups List all of the package groups on the specified --volume. --groups-plist List all of the package groups on the specified --volume in Mac OS X plist(5) format. --group-pkgs group-id List all of the packages that are members of this group-id. --file-info path Show the metadata known about path. --file-info-plist path Show the metadata known about path in Mac OS X plist(5) format. FILE COMMANDS
--expand pkg-path dir-path Expand the flat package at pkg-path into a new directory specified by dir-path. --flatten dir-path pkg-path Flatten the dir-path into a new flat package created at pkg-path. The directory to be flattened must have the proper contents and layout for a flat package. This is not intended as a substitute for pkgbuild(1). --bom path Extract any BOM files from the flat pkg at path into /tmp and return the filename(s). Suggested use is as an argument to lsbom(8). Eg, "lsbom `pkgutil --bom path`". Note that some flat package archives may contain no BOM, one BOM, or several BOMs. --payload-files path List the files archived within the payload of the uninstalled flat package(s) contained at path. This should be equivalent to "lsbom -s `pkgutil --bom path`". Note that flat package archives may contain more than one package, and the destination location for the uninstalled package(s) is unknown to this command. --check-signature pkg-path Check the validity and trust of the signature on the package at pkg-path. In addition to the status of the signature, the asso- ciated certificate chain will be shown. SEE ALSO
installer(8) pkgbuild(1) productbuild(1) Mac OS March 2, 2011 Mac OS