X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=src%2Fwimlib.h;h=ed036e7bad51d8f5d3f57442345e2ca2781d9d18;hb=f3bfbdd5c07b4b096a2e8a35a03e9dfc6269e41f;hp=479fa241791a902016dd7ce515b5610028f7baf1;hpb=aee5df8a6702da0782d64333eb8b3d1fb52c880b;p=wimlib diff --git a/src/wimlib.h b/src/wimlib.h index 479fa241..ed036e7b 100644 --- a/src/wimlib.h +++ b/src/wimlib.h @@ -697,14 +697,17 @@ struct wimlib_capture_config { /** Reparse-point fixups: Modify absolute symbolic links (or junction points, * in the case of Windows) that point inside the directory being captured to * instead be absolute relative to the directory being captured, rather than the - * current root. + * current root; also exclude absolute symbolic links that point outside the + * directory tree being captured. * - * Without this flag, the default is to do the reparse-point fixups if - * WIM_HDR_FLAG_RP_FIX is set in the WIM header. */ + * Without this flag, the default is to do this if WIM_HDR_FLAG_RP_FIX is set in + * the WIM header or if this is the first image being added. + * WIM_HDR_FLAG_RP_FIX is set if the first image in a WIM is captured with + * reparse point fixups enabled and currently cannot be unset. */ #define WIMLIB_ADD_IMAGE_FLAG_RPFIX 0x00000100 -/* Don't do reparse point fixups. Without this flag, the default is to do - * reparse point fixes if WIM_HDR_FLAG_RP_FIX is set in the WIM header. */ +/* Don't do reparse point fixups. The default behavior is described in the + * documentation for ::WIMLIB_ADD_IMAGE_FLAG_RPFIX. */ #define WIMLIB_ADD_IMAGE_FLAG_NORPFIX 0x00000200 /****************************** @@ -754,6 +757,16 @@ struct wimlib_capture_config { * not have permission to set the desired one. */ #define WIMLIB_EXTRACT_FLAG_STRICT_ACLS 0x00000080 +/* Extract equivalent to ::WIMLIB_ADD_IMAGE_FLAG_RPFIX; force reparse-point + * fixups on, so absolute symbolic links or junction points will be fixed to be + * absolute relative to the actual extraction root. Done by default if + * WIM_HDR_FLAG_RP_FIX is set in the WIM header. */ +#define WIMLIB_EXTRACT_FLAG_RPFIX 0x00000100 + +/** Force reparse-point fixups on extraction off, regardless of the state of the + * WIM_HDR_FLAG_RP_FIX flag in the WIM header. */ +#define WIMLIB_EXTRACT_FLAG_NORPFIX 0x00000200 + /****************************** * WIMLIB_MOUNT_FLAG_* * ******************************/