JSrSSKJr SSKJr SSKJr SSKJr SSKJr SSKrSSK r SSK r SSK r SSK r SSK r SSKJr SS KJr SS KJr SS KJr SS KJr SS KJr \(dSSKrSSKr\ R6(a\rSrSrSr Sr!Sr"Sr#Sr$Sr%\ RL"S5r'Sr(Sr)Sr*Sr+Sr,Sr-Sr.Sr/Sr0Sq1\2"5q3"SS\45r5"S S!\45r6S"r7S#r8S1S$jr9S%r:S&r;S'r<\$\$\%4S(jr=S2S)jr>S*r?S+r@S,rAS-rBS.rCS/rDS0rEg)3zHelper file for POSIX methods.)absolute_import)print_function)division)unicode_literals)timegmN)CommandException)UTC)CreateCustomMetadata) GetValueFromObjectCustomMetadata) IS_WINDOWS)SECONDS_PER_DAYzgoog-reserved-file-atimezgoog-reserved-posix-gidzgoog-reserved-posix-modezgoog-reserved-file-mtimezgoog-reserved-posix-uidz ^[0-7]{3}$@ c,\rSrSrSr\\\\S4SjrSrg)POSIXAttributesSz1Class to hold POSIX attributes for a file/object.NcnXlX lX0lX@l[ U(aUO[ 5Ulg)aConstructor for POSIXAttributes class which holds relevant data. Args: atime: The access time of the file/object. mtime: The modification time of the file/object. uid: The user ID that owns the file. gid: The group ID that the user is in. mode: An instance of POSIXMode. N)atimemtimeuidgid POSIXModeNA_MODEmode)selfrrrrr"s )platform/gsutil/gslib/utils/posix_util.py__init__POSIXAttributes.__init__Vs(JJHH$$G4DI)rrr"rr) __name__ __module__ __qualname____firstlineno____doc__NA_TIMENA_IDr%__static_attributes__r'r$rrSs9 5r'rc\rSrSrSrSrg)r lcXlg)N permissions)r#r5s r$r%POSIXMode.__init__ns"r'r4N)r(r)r*r+r%r/r0r'r$r r ls#r'r c0[[U5SS5$)z7Converts a base-10 mode integer from os.stat to base-8.N)intoctr"s r$ConvertModeToBase8r<rs SYrs^ r'c[5n[U[[5up4[ U5nU(aU[::a[ SU5 [nO;U[ [ R "55[-:a[SU5 [nXBl [U[X5 [U[X5 [U[[ 5up5U(a6["R%U5(a['[)U55UlU$U$![a [SU5 [nNf=f![a [SU5 U$f=f)a3Parses the POSIX attributes from the supplied metadata. Args: obj_metadata: The metadata for an object. url_str: File/object path that provides context if a warning is thrown. Returns: A POSIXAttribute object with the retrieved values or a default value for any attribute that could not be found. rr")rr ATIME_ATTRr-longWarnNegativeAttributetimer WarnFutureTimestamp ValueErrorWarnInvalidValuerDeserializeIDAttributeGID_ATTRUID_ATTR MODE_ATTRr! MODE_REGEXmatchr r9r") obj_metadataurl_str posix_attrsfoundrr"s r$+DeserializeFileAttributesFromObjectMetadatarOys !+1, 29;,%  KE '!GW-e diik"_4 4'7+exFxF0y18:+% z%%("3t9-k ! Wg& E (vw' (s).D ;D .D- D*)D*-EEc UR[:wa[[UR0US9 U(aUR[:wa[[ UR0US9 UR [:wa[[UR 0US9 UR[:wa[[UR0US9 URR[:wa%[[URR0US9 ggg)aTakes a POSIXAttributes object and serializes it into custom metadata. Args: posix_attrs: A POSIXAttributes object. custom_metadata: A custom metadata object to serialize values into. preserve_posix: Whether or not to preserve POSIX attributes other than mtime. )entriescustom_metadataN)rr-r MTIME_ATTRrr>rr.rGrrFr"r5r!rH)rMrRpreserve_posixs r$'SerializeFileAttributesToObjectMetadatarUs'!*k.?.?!@)8:G#J 0A0A#B+:<%Hkoo#>+:<%Hkoo#>+:<##w.I{/?/?/K/K#L+:</r'cURS5Sn[X[5upV[U5nU(aU[::a[ XB5 [n[X4U5 g![ a [ XB5 [nN*f=f)aParses the POSIX attributes from the supplied metadata into posix_attrs. Args: obj_metadata: The metadata for an object. attr: Either GID_ATTR or UID_ATTR. url_str: File/object path that provides context if a warning is thrown. posix_attrs: POSIXAttribute object. -rN)splitr r.r9r@rCrDsetattr)rKattrrLrM attr_namerNvals r$rErEsrjjob!)/ EJ*% c(C I/ c +#& Y( Cs-A""B?Bc [5n U[:n U[:n U[:n U[:nU[:nU[:nU[:nU[:nU[:nU [:nU (a U (dX lU (a U(dX*lU(a U(dXJlU(a U(dXjlU(aU(dXRl X=(a U (+=(dU U =(a U(+=(d> U=(a U(+=(d' U=(a U(+=(d U=(a U(+4$)aChecks whether an update for any POSIX attribute is needed. Args: src_atime: The source access time. dst_atime: The destination access time. src_mtime: The source modification time. dst_mtime: The destination modification time. src_uid: The source user ID. dst_uid: The destination user ID. src_gid: The source group ID. dst_gid: The destination group ID. src_mode: The source mode. dst_mode: The destination mode. Returns: A tuple containing a POSIXAttribute object and a boolean for whether an update was needed. ) rr-r.r!rrrrr"r5) src_atime dst_atime src_mtime dst_mtimesrc_uiddst_uidsrc_giddst_gidsrc_modedst_moderM has_src_atime has_dst_atime has_src_mtime has_dst_mtime has_src_uid has_dst_uid has_src_gid has_dst_gid has_src_mode has_dst_modes r$NeedsPOSIXAttributeUpdaterrs* !+g%-g%-g%-g%-%+%+%+%+G#,G#,=!=!OO,#+ ;m*;;%;m*;;#7K;$7K;%9\)9  <= 4. Args: mode: The mode as a 3-digit, base-8 integer. Returns: True/False r8N)rIrJr:U_RG_RO_Rr;s r$ValidatePOSIXModerw sC   #d)BC. ) ;tcz0:TCZ0:/3cz;r'c`[(agU[:n[U5[:nU[:nU(dU(dU(dg[R "5S:Xag[ [[U5S55nU(aU(dSSU-4$O[[5nU(a[R"U5 U(a[R"U5 U[R"5:Hn[[U5S5nU(d:U(a3U(a,[!U["-5(dSSX[%U5S S 4-4$U(a0[!U["-5n X(aS 4$S X[%U5S S 4-4$[U5[&;a0[!U[(-5n X(aS 4$SX[%U5S S 4-4$U[*-(agU(dU(dU(agSS U-4$![[4a SSX4-4s$f=f![[4a SSX4-4s$f=f)aValidates that the user has file access if uid, gid, and mode are applied. Args: url_str: The path to the object for which this is validating. uid: A POSIX user ID. gid: A POSIX group ID. mode: A 3-digit, number representing POSIX permissions, must be in base-8. Returns: A (bool, str) tuple, True if and only if it's safe to copy the file, and a string containing details for the error. )TrrFz$Mode for %s won't allow read access.z3UID for %s doesn't exist on current system. uid: %dz3GID for %s doesn't exist on current system. gid: %dz?Insufficient access with uid/gid/mode for %s, gid: %d, mode: %sr8Nryz?Insufficient access with uid/gid/mode for %s, uid: %d, mode: %sz"There was a problem validating %s.)r r.r9r!osgeteuidrwstrSYSTEM_POSIX_MODEpwdgetpwuidKeyError OverflowErrorgrpgetgrgidgetuidboolrtr: USER_GROUPSrurv) rLrrr" uid_present gid_present mode_present mode_validuid_is_current_uservalids r$ValidateFilePermissionAccessrs8Z e +C5 +,  ZZ\Q  SY!23*  ;gE EE   !D ll3 ll3ryy{* SY $ d4#:>N>N !D "#78 99  E 2 99 !D "#7 8 99 3x;  E 2 99 !D "#7 8 99 cz  {z  4w> >>S m $Kn m $Kns$,G4 H4HHH-,H-c"Uc[SU-5e[U[[S9upE[U[[S9upg[U[ [ S9up[U[[ S9up[U[[S9upU(aL[U5nU(d9[R"U5Rn[R"XU45 gO4U(a-[UR 5n[R"XU45 U(dgU(a [U5nU[:a#U[:a[R"XU45 OU[:aCU[::a9[R"U5R"n[R"XU45 OLU[::aBU[:a8[R"U5Rn[R"XU45 [$(agU(a%[R&"5S:Xa [)U 5n O[ n U (a [)U 5n U [ :a"U [ :a[R*"X U 5 OXU [ :a"U [ ::a[R*"X S5 O,U [ ::a"U [ :a[R*"USU 5 U (a,[)[-U 5S5n [R."X 5 gg![0a [SUR2-5ef=f)aParses POSIX attributes from obj_metadata and sets them. Attributes will only be set if they exist in custom metadata. This function should only be called after ValidateFilePermissionAccess has been called for the specific file/object so as not to orphan files. Args: path: The local filesystem path for the file. Valid metadata attributes will be set for the file located at path, some attributes will only be set if preserve_posix is set to True. obj_metadata: The metadata for the file/object. is_rsync: Whether or not the caller is the rsync command. Used to determine if timeCreated should be used. preserve_posix: Whether or not all POSIX attributes should be set. Nz"obj_metadata cannot be None for %s) default_valuerrrz#Check POSIX attribute values for %s)rr r>r-rSrGr.rFrHr!r?rzstatst_atimeutimeConvertDatetimeToPOSIX timeCreatedst_mtimer r{r9chownr|chmodrCname)pathrKis_rsyncrTfound_atrfound_mtr found_uidr found_gidr found_moder" atime_tmp mtime_tmps r$ParseAndSetPOSIXAttributesrosd& ?$F GGE.6|7AELNOH7|7AELNOH6l6>DIKNI6l6>DIKNI8 8AFMOJ5ke GGDM**  5)* $\%=%=>ehhtU^$  5ke w57?hhtU^$ Ug-''$-((ihhtY'( ' ego''$-((ihht'(z RZZ\Q& Hc c Hc U{sU{hht# uhht" #+hhtR TA dhht . @',,- ...s B:K+B/ B/ c,[5 [5 g)zrFrHrSrGr-r.r!compilerIrtU_WU_XruG_WG_XrvO_WO_Xr}rrobjectrr r<rOrUrErrrwrrr@rDrBrrrrr0r'r$rsO%&%' ,:F.1  77 $( $ & ' $    ZZ %          e 5f52## 'X',.