7TSrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK J r SSK J r SSK J r SS KJr SS KJr SS KJr S rS rSrSrSrSrSrSrSrSrSrSrSr "SS5r!\RD"SSS/5r#Sr$Sr%\RL"S S!9S"5r'S#r(S1S$jr)\RD"S%/S&Q5r*S2S'jr+S3S(jr,S)r-S*r.S+r/S,r0S2S-jr1S.r2S/r3S0r4g)4z%POSIX utilities for storage commands.)absolute_import)division)unicode_literalsN)errors) storage_url)resource_reference)log)function_result_cache) platformsz;UID in {} metadata doesn't exist on current system. UID: {}z;GID in {} metadata doesn't exist on current system. GID: {}z|Insufficient access to local destination to apply {}. User {} owns file, but owner does not have read permission in mode {}.zInsufficient access to local destination to apply {}. Group {} would own file, but group does not have read permission in mode {}.zInsufficient access to local destination to apply {}. UID {} is not owner of file, and user is not in a group that owns the file. Users in "other" category do not have read permission in mode {}.zgoog-reserved-file-atimezgoog-reserved-posix-gidzgoog-reserved-posix-modezgoog-reserved-file-mtimezgoog-reserved-posix-uidiQcP[U5SSnUSSnSS[U5- -U-$)zCTakes base ten integer, converts to octal, and removes extra chars.N0)octlen) base_ten_int oct_stringpermission_bytess 4lib/googlecloudsdk/command_lib/storage/posix_util.py"convert_base_ten_to_base_eight_strr=s=< $*_ C()) *-= ==c[US5$)zHTakes string representing integer in octal and converts to base ten int.)int)base_eight_strs r&convert_base_eight_str_to_base_ten_intrHs ^Q rcJ\rSrSrSrSr\S5r\S5rSr Sr Sr g ) PosixModeNz(Stores POSIX mode in all useful formats.cXlX lg)z8Initializes class. Prefer the 'from' constructors below.N)rr)selfrrs r__init__PosixMode.__init__Qs$(rcB[U5n[[U5U5$)z-Initializes class from base ten int. E.g. 73.)rrr)clsrrs rfrom_base_ten_intPosixMode.from_base_ten_intVs'8 EN .~> PPrc,[[U5U5$)z=Initializes class from base eight (octal) string. E.g. '111'.)rr)r&rs rfrom_base_eight_strPosixMode.from_base_eight_str^s .~> PPrc[U[U55(d[$URUR:H=(a URUR:H$)N) isinstancetypeNotImplementedrr)r"others r__eq__PosixMode.__eq__dsK eT$Z ( (    !3!3 3 8   5#7#7 79rcNSRURUR5$)Nz&(base-ten int: {}, base-eight str: {}))formatrr)r"s r__repr__PosixMode.__repr__js& 3 : : 4.. 00r)rrN) __name__ __module__ __qualname____firstlineno____doc__r# classmethodr'r*r1r5__static_attributes__rrrrNs@0) PPPP 9 0rrSystemPosixData default_mode user_groupscSn[R"S5n[R"U5 X- nUS-n[RU5$)zDGets default permissions files are created with as PosixMode object.ii)osumaskrr')max_permissions current_umaskmodemode_without_executions r_get_default_moderJysJ/((5/-((=  ($ %<  $ $%; <RXU R455n [!X5 g![a8 [R"[RX55n [!X5 GNf=f![[$4a8 [R"[&RX55n [!X5 GNf=f)aDetects permissions causing inaccessibility. Can delete invalid file. Args: system_posix_data (SystemPosixData): Helps determine if file will be made inaccessible in local environment. resource (ObjectResource): Contains URL used for messages and custom POSIX metadata used to determine if setting invalid file permissions. delete_path (str|None): If present, will delete file before raising error. Useful if file has been downloaded and needs to be cleaned up. known_posix (PosixAttributes|None): Use pre-parsed POSIX data instead of extracting from source. Not super important here because the source is a cloud object and doesn't require an `os.stat` call to harvest metadata, but it would be strange if we used `known_posix` for callers and only `resource` here, especially if the values were different (which they shouldn't be). Be careful using this because, if the data is wrong, it could mess with these safety checks. Raises: SystemPermissionError: Has explanatory message about issue. Nrz[user primary group]) (get_posix_attributes_from_cloud_resourcer r]r^rDgeteuidrLrMr url_stringrOKeyErrorrSystemPermissionError_MISSING_UID_FORMATr4rdgetgrgid OverflowError_MISSING_GID_FORMATr@rNrstatS_IRUSR%_INSUFFICIENT_USER_READ_ACCESS_FORMATrrAS_IRGRP&_INSUFFICIENT_GROUP_READ_ACCESS_FORMATS_IROTH&_INSUFFICIENT_OTHER_READ_ACCESS_FORMAT)system_posix_dataresourcerc known_posix_uidgidrHrLrMrhrb mode_to_set uid_to_sets r!raise_if_invalid_file_permissionsr~sI:G=hG!QS  D  Y%>%>%H%H%J%J ZZ\Q   ##..*_= ll3  _= ll3 \#00KK!biik*[C299;&$,,.  ( (-44 K$>$>  E 'u:[C888$,,.  ( (.55 &)k "s  & &  E'u: ,  & &,33 +"<"< % %U8o =**  $ $Z 5e)< = m $=**  $ $Z 5e)< =s% H:I?:>I<;I<?AKKPosixAttributes)atimemtimerzr{rHc U(+=(d! [R[R;n[R"XS9u n pEpdpxn[XxXV[R U55$)z3Takes file path and returns PosixAttributes object.follow_symlinks)rDrosupports_follow_symlinksrrr') file_pathpreserve_symlinksrrHryrzr{rrs rget_posix_attributes_from_filer(sf Irwwb.I.II131-$1aceA s"44T: <>@ KK ++16 %%00(2H2H2M,   5 KK@GG  + +S2H2H2M   sD00AFFc UR(aURRU5cg[URU5nUS:aH[R "SR URRXRU55 gU$![aJ [R "SR URRXRU55 gf=f)z/Finds, validates, and returns a POSIX ID value.Nrrz-Found negative ID value in {} metadata {}: {}) rrrrr rr4rrh)rwrposix_ids r _extract_id_from_custom_metadatars   8#9#9#=#=c#B#J 8))#./H\KK7>>  + +S2H2H2M   / KK@GG  + +S2H2H2M   sBAC,+C,c tUR(a URR[5cg[R UR[5$![ aS [ R"SRURR[UR[55 gf=f)z1Finds, validates, and returns a POSIX mode value.NzG{} metadata did not contain a valid permissions octal string for {}: {}) rrMODE_METADATA_KEYrr*rr rr4rrh)rws r"_extract_mode_from_custom_metadatars     # #$5 6 >    ( (01  KK f  + +   " "#4 5  s%AAB76B7c[U[5n[U[5n[U[5n[U[ 5n[ U5n[XX4U5$)a[Parses metadata_dict and returns PosixAttributes. Note: This parses an object's *custom* metadata with user-set fields, not the full metadata with provider-set fields. Args: resource (ObjectResource): Contains URL to include in logged warnings and custom metadata to parse. Returns: PosixAttributes object populated from metadata_dict. )rATIME_METADATA_KEYMTIME_METADATA_KEYrUID_METADATA_KEYGID_METADATA_KEYrr)rwrrrzr{rHs rrfrfsQ -X7I J% ,X7I J%(3CD#(3CD# +H 5$ s 66rc2[U[R5(a [U5$[U[R5(a [ UR RU5$[R"SRUR55e)z,Parses unknown resource type for POSIX data.zECan only retrieve POSIX attributes from file or cloud object, not: {}) r-rObjectResourcerfFileObjectResourcerrrrInvalidUrlErrorr4 TYPE_STRING)rwrs r"get_posix_attributes_from_resourcers~,;;<< 3H ==,??@@ )**,=   4 45 rcURb[UR5U['URb[UR5U['UR b[UR 5U[ 'URb[UR5U['URbURRU['gg)z7Updates custom metadata_dict with PosixAttributes data.N) rstrrrrrzrr{rrHrr) metadata_dictposix_attributess r1update_custom_metadata_dict_with_posix_attributesr's'(+,<,B,B(CM$%'(+,<,B,B(CM$%%&)*:*>*>&?M"#%&)*:*>*>&?M"#&'7'<'<'K'KM#$'rc[U[R5(a6UR(a%[R "SR U55e[U[R5(a6UR(a%[R "SR U55e[U[R5(a6[U[R5(a[R "S5egg)zGLogs errors and returns bool indicating if transfer is valid for POSIX.z(Cannot preserve POSIX data from pipe: {}z#Cannot write POSIX data to pipe: {}z4Cannot preserve POSIX data for cloud-to-cloud copiesN)r-rFileUrl is_streamrrr4CloudUrl) source_urldestination_urls r 7-1rcRU(dU(aUR(aU"U0UD6$g)zEUseful for gating functions without repeating the below if statement.N)preserve_posix) posix_to_setuser_request_argsfunctionargskwargss rrun_if_setting_posixrJs&',=,L,L T $V $$ r)NN)F)NNF)5r; __future__rrr collectionsrrDro"googlecloudsdk.command_lib.storagerr,googlecloudsdk.command_lib.storage.resourcesrgooglecloudsdk.corer googlecloudsdk.core.cacher googlecloudsdk.core.utilr rkrnrqrsrurrrrrrrrr namedtupler?rJrYlrur_rdr~rrrrrrrfrrrrr>rrrsY,&' 5:K#;.BBA& K' @'0,./,> 00N(():*8-)HJ=$ C 1%4&4 j9n((?A <   |~ F..7*  L(r