Rename parser token REF to REF_P to avoid a symbol conflict.

tglsfdc · tglsfdc · commit fec443414bbe · 2022-10-16T15:27:04.000-04:00
In the latest version of Apple's macOS SDK, <sys/socket.h> fails to compile if "REF" is #define'd as something. Apple may or may not agree that this is a bug, and even if they do accept the bug report I filed, they probably won't fix it very quickly. In the meantime, our back branches will all fail to compile gram.y. v15 and HEAD currently escape the problem thanks to the refactoring done in 98e93a1, but that's purely accidental. Moreover, since that patch removed a widely-visible inclusion of <netdb.h>, back-patching it seems too likely to break third-party code. Instead, change the token's code name to REF_P, following our usual convention for naming parser tokens that are likely to have symbol conflicts. The effects of that should be localized to the grammar and immediately surrounding files, so it seems like a safer answer. Per project policy that we want to keep recently-out-of-support branches buildable on modern systems, back-patch all the way to 9.2. Discussion: https://postgr.es/m/1803927.1665938411@sss.pgh.pa.us
diff --git a/src/backend/parser/gram.y b/src/backend/parser/gram.y
@@ -544,7 +544,7 @@ static void processCASbits(int cas_bits, int location, const char *constrType,
 
 	QUOTE
 
-	RANGE READ REAL REASSIGN RECHECK RECURSIVE REF REFERENCES REINDEX
+	RANGE READ REAL REASSIGN RECHECK RECURSIVE REF_P REFERENCES REINDEX
 	RELATIVE_P RELEASE RENAME REPEATABLE REPLACE REPLICA
 	RESET RESTART RESTRICT RETURNING RETURNS REVOKE RIGHT ROLE ROLLBACK
 	ROW ROWS RULE
@@ -11355,15 +11355,15 @@ xmlexists_argument:
 				{
 					$$ = $2;
 				}
-			| PASSING c_expr BY REF
+			| PASSING c_expr BY REF_P
 				{
 					$$ = $2;
 				}
-			| PASSING BY REF c_expr
+			| PASSING BY REF_P c_expr
 				{
 					$$ = $4;
 				}
-			| PASSING BY REF c_expr BY REF
+			| PASSING BY REF_P c_expr BY REF_P
 				{
 					$$ = $4;
 				}
@@ -12461,7 +12461,7 @@ unreserved_keyword:
 			| REASSIGN
 			| RECHECK
 			| RECURSIVE
-			| REF
+			| REF_P
 			| REINDEX
 			| RELATIVE_P
 			| RELEASE
diff --git a/src/include/parser/kwlist.h b/src/include/parser/kwlist.h
@@ -297,7 +297,7 @@ PG_KEYWORD("real", REAL, COL_NAME_KEYWORD)
 PG_KEYWORD("reassign", REASSIGN, UNRESERVED_KEYWORD)
 PG_KEYWORD("recheck", RECHECK, UNRESERVED_KEYWORD)
 PG_KEYWORD("recursive", RECURSIVE, UNRESERVED_KEYWORD)
-PG_KEYWORD("ref", REF, UNRESERVED_KEYWORD)
+PG_KEYWORD("ref", REF_P, UNRESERVED_KEYWORD)
 PG_KEYWORD("references", REFERENCES, RESERVED_KEYWORD)
 PG_KEYWORD("reindex", REINDEX, UNRESERVED_KEYWORD)
 PG_KEYWORD("relative", RELATIVE_P, UNRESERVED_KEYWORD)

Original file line number	Diff line number	Diff line change
`@@ -544,7 +544,7 @@ static void processCASbits(int cas_bits, int location, const char *constrType,`
`544`	`544`
`545`	`545`	`QUOTE`
`546`	`546`
`547`		`- RANGE READ REAL REASSIGN RECHECK RECURSIVE REF REFERENCES REINDEX`
	`547`	`+ RANGE READ REAL REASSIGN RECHECK RECURSIVE REF_P REFERENCES REINDEX`
`548`	`548`	`RELATIVE_P RELEASE RENAME REPEATABLE REPLACE REPLICA`
`549`	`549`	`RESET RESTART RESTRICT RETURNING RETURNS REVOKE RIGHT ROLE ROLLBACK`
`550`	`550`	`ROW ROWS RULE`
`@@ -11355,15 +11355,15 @@ xmlexists_argument:`
`11355`	`11355`	`{`
`11356`	`11356`	`$$ = $2;`
`11357`	`11357`	`}`
`11358`		`- \| PASSING c_expr BY REF`
	`11358`	`+ \| PASSING c_expr BY REF_P`
`11359`	`11359`	`{`
`11360`	`11360`	`$$ = $2;`
`11361`	`11361`	`}`
`11362`		`- \| PASSING BY REF c_expr`
	`11362`	`+ \| PASSING BY REF_P c_expr`
`11363`	`11363`	`{`
`11364`	`11364`	`$$ = $4;`
`11365`	`11365`	`}`
`11366`		`- \| PASSING BY REF c_expr BY REF`
	`11366`	`+ \| PASSING BY REF_P c_expr BY REF_P`
`11367`	`11367`	`{`
`11368`	`11368`	`$$ = $4;`
`11369`	`11369`	`}`
`@@ -12461,7 +12461,7 @@ unreserved_keyword:`
`12461`	`12461`	`\| REASSIGN`
`12462`	`12462`	`\| RECHECK`
`12463`	`12463`	`\| RECURSIVE`
`12464`		`- \| REF`
	`12464`	`+ \| REF_P`
`12465`	`12465`	`\| REINDEX`
`12466`	`12466`	`\| RELATIVE_P`
`12467`	`12467`	`\| RELEASE`