Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xbssnapshot(1) [osx man page]

XBSSNAPSHOT(1)							   CoreXBS Tools						    XBSSNAPSHOT(1)

NAME
xbssnapshot - CoreXBS snapshot utility SYNOPSIS
xbssnapshot fetch [--[no]live] [--age hours] [--[no]xpc] train_name xbssnapshot authcheck [--timeout seconds] train_name DESCRIPTION
In the 1st form, xbssnapshot is used to obtain a snapshot of Cortex for train_name. A cache of snapshots is maintained in a directory, which may or may not be used in addition to consulting the Cortex servers depending on command line OPTIONS specified. If successful, a file URL of a suitable snasphot is printed to STDOUT. On failure, a description of the failure is printed to STDERR. In the 2nd form, xbssnapshot is used to check connectivity to the Cortex servers for train_name and determine if AppleConnect (Single Sign-On) credentials will be required to obtain a snapshot. If the Cortex server can be reached, YES is printed to STDOUT if SSO authenti- cation is required and NO is printed if not. On failure (including not being able to reach the Cortex servers), a description of the fail- ure is printed to STDERR. OPTIONS
--live Force xbssnapshot to bypass the snapshot cache directory and fetch data from Cortex. --nolive Force xbssnapshot to not fetch data from Cortex and only use the snapshot cache directory. --age hours When considering if a snapshot found in the snapshot cache directory is "new enough", only accept snapshots that are less than hours old. --xpc Use XPC service when fetching data from Cortex. This is the default. --noxpc Bypass XPC service when fetching data from Cortex. --timeout seconds When performing connectivity test with Cortex server(s), how long to wait before assuming no connectivity to a given Cortex server. RETURN VALUES
Returns 0 on success, and non-zero on failure. ENVIRONMENT
CTXHost May be set to the hostname of a specific Cortex server. This is mainly only useful to the developers. CTXPort May be set to specific port to connect to CTXHost on (does nothing unless CTXHost is also set). This is mainly only useful to the developers. FILES
/Library/Caches/com.apple.bni.cortexsnapshot Directory where snapshots are cached. /var/log/system.log CoreXBS framework and XPC services log here. grep CoreXBS /var/log/system.log may show additional information above and beyond what xbssnapshot prints on it's own. BUGS
If you encounter issues with xbssnapshot, please file a Radar. Component is "CBL - CoreXBS|X". Please include the following information, if possible: 1. Output of xbssnapshot, including command line it was invoked with. 2. Output of ls -lh /Library/Caches/com.apple.bni.cortexsnapshot 3. Output of grep CoreXBS /var/log/system.log 4. If a snapshot was fetched, a copy of the snapshot. AUTHOR
Problems with xbssnapshot should be addressed via Radar (see BUGS). For discussion and advice from other users please subscribe to xbs-help@group.apple.com. The maintainers of xbssnapshot are cbt@group.apple.com. Suggestions and comments are always welcome! Core Build Technologies March 2013 XBSSNAPSHOT(1)

Check Out this Related Man Page

fssnap(1M)                                                System Administration Commands                                                fssnap(1M)

NAME
fssnap - create temporary snapshots of a file system SYNOPSIS
fssnap [-F FSType] [-V] -o special_options /mount/point fssnap -d [-F FSType] [-V] /mount/point | dev fssnap -i [-F FSType] [-V] [-o special_options] [/mount/point | dev] DESCRIPTION
The fssnap command creates a stable, read-only snapshot of a file system when given either an active mount point or a special device con- taining a mounted file system, as in the first form of the synopsis. A snapshot is a temporary image of a file system intended for backup operations. While the snapshot file system is stable and consistent, an application updating files when the snapshot is created might leave these files in an internally inconsistent, truncated, or otherwise unusable state. In such a case, the snapshot will contain these partially written or corrupted files. It is a good idea to ensure active applications are suspended or checkpointed and their associated files are also consis- tent during snapshot creation. File access times are not updated while the snapshot is being created. A path to the virtual device that contains this snapshot is printed to standard output when a snapshot is created. OPTIONS
The following options are supported: -d Deletes the snapshot associated with the given file system. -F FSType Specifies the file system type to be used. The FSType should either be specified here or be determined by matching the block special device with an entry in the /etc/vfstab table, or by consulting /etc/default/fs. -i Displays the state of any given FSType snapshot. If a mount-point or device is not given, a list of all snapshots on the system is displayed. When a mount-point or device is specified, detailed information is provided for the specified file system snapshot by default. The format and meaning of this information is file-system dependent. See the FSType-specific fssnap man page for details. -o special_options See the FSType-specific man page for fssnap. -V Echoes the complete command line, but does not execute the command. OPERANDS
The following operands are supported: /mount/point The directory where the file system resides. EXAMPLES
See FSType-specific man pages for examples. EXIT STATUS
The following exit values are returned: 0 Successful completion. >0 An error occurred. FILES
/etc/vfstab Specifies file system type. /etc/default/fs Specifies the default local file system type. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ SEE ALSO
fssnap_ufs(1M), attributes(5) NOTES
This command might not be supported for all FSTypes. SunOS 5.10 11 Aug 2004 fssnap(1M)
Man Page